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The photographs reproduced below rcnre<;enr - , 

proposed Macintosh computer The scr Prellninary nccV-uj. of tht- 

it is not knovn If a dual disk drivp ITJ''''^ accurately presented, however 
design in no wav represents the f nil "''^ available. The ca-se 

was created to help give a feel for LlTn"""""" °' ^^"^""'^ computer, but 

If a printer Is included, ir n l.:" . rP."^""^'^ °f s"ch a machine, 

the 5 Inches shown m the mock-up. ^ ^'^ ^" rather than 

It is recommended that these documents be read in the following order- 

1. M 0. the table of contents to the collection 

2. M 34, the summary of January lopo 
3- M 2. the list of areas of concern 

and then, via the table of contents, any further ite.s of interest. 
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THE MACINTOSH PROJECT 
DOCUMENT VERSION 11 

TITLE: CATALOG TO MACINTOSH DOCUMENTS 

AUTHOR: JEF RASKIN 

DATE: 28 Sep- 13 Feb 80. 

/ M 0. 11 CATALOG* 

A chronologically arranged annotated listing of all Macintosh 
^ documents. The very document that you are reading. If there is 
no asterisk aiter a document title, that document is either 
obsolete or is especially technical. 

^ M l.A INTRODUCTION AND PRELIMINARY CONVENTIONS 

2 The conventions for documents, their distribution and cataloging. 

M 2.9 OVERVIEW OF PRELIMINARY AREAS OF CONCERN* 

^ A list-, slightly annotated, of the various questions that must be 
answered in designing Macintosh. It is rather comprehensive. 

M 3.5 THE APPLE COMPUTER NETWORK* 

Justification of and preliminary thoughts on a network. An appendix 
lists some names and addresses of networks. 

^M 4.1 THOUGHTS OK ANNIE 

n An old memo, from May '79, with some early thoughts on what was 
to become the Macintosh project. Eccentric use of English. 

•^M 5.1 PRELIMINARY COST INVESTIGATION* 

A brief rundown on the cost of the major electopic and mechanical 
^ components of Macintosh. The $500 selling price is s^vown to be 
a difficult mark to reach. 

" M 6.2 GENERAL CRITERIA 

^ An expansion of the general criteria listed in M 2.6, defining the 
major goals of the project. 

M 7. 7 A MODEL OF MEMORY VS DISK CHOICES 

A A description of the design of a mathematical model. This is the 
' documentation for M 9 and M 10. 

M 8. 1 PERSONAL AIMS 

2, My aims in doing the Macintosh project. 

M 9.6 PASCAL MODEL OF MEMORY VS DISK CHOICES 

I — 1 A non-interactive program that sweeps through various 
' — ' document and memory sizes. Superceded by M 10. 

M 10.3 INTERACTIVE PASCAL MODEL OF MEMORY VS DISK CHOICES 

B An interactive model that allows you to easily vary parameters. 
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M 11.0 SUMMARY OF OCTOBER 10 

A few of the main points of the project as of October 10, prepared 
3 for a meeting with Whitney, Carlson, Jobs, Markkula, Holt, Scott 
Roybal and Raskin. 

M 12.1 CONCERNS ABOUT USING THE TELEPHONE WITH PERSONAL COMPUTERS* 
o An article written for magazine publication on the probable- 
difficulties we might encounter working with Ha Bell. 

M 13.1 IMPORTANT POINTS ABOUT MACINTOSH 

A one page summary of the summary of October 10, prepared 



1 



for the meeting of 12 October. 



M 14.10 THE APPLE CALCULATOR LANGUAGE* 

This is an extensive document, not complete as of this version 
of the catalog (22 October 79) which contains a primer of a good 
portion of the language, the BNF and other technical considerations 
for those portions described, and some of the justification for 
the language. (Read M15 before reading this document.) 

M 15.0 MASS "STORAGE PRINTER/FACSIMILE DEVICE* 

_ A description and discussion of a low cost device, based on present 
thermal or electrostatic discharge printer technology, that would 
provide printing, data and program storage and dissemination, 
facsimile transmission, and digitlElng abilities to Macintosh. 

M 16.0 AN INTRODUCTION TO THE APPLE LANGUAGE FOR CALCULATOR USERS* 
^ An indication of how a primer for the language of M 14 might be 
written. 

M 17.0 REPORT ON THE HP 41C AND SHARP 5l'00 CALCULATORS 

^ What we can learn from them that helps in the design of Macintosh. 

M 18.0 ON THE PROBLEM OF DELIMITING STRINGS IN PROGRAMS 

J A justification of the string delimiting mechanism used in the Apple 
language described in MIA. 

M 19.2 THE MACINTOSH EDITOR* 

^ The initial design of a very user-oriented, fast editor. 

M 20.0 THE MACINTOSH DISPLAY* 

^ Descriptions and some simulations of the proposed display. 



M 21.0 THE ON-LINE TEXT EDITING SYSTEM* 

A description of the SRI text editing system developed in the late 
1960's by Englebart. Some very interesting Ideas. 



8 



M 22.1 HOW CAN WE MAKE COMPUTERS TRULY PERSONAL?* 

^ A guest editorial Raskin wrote for a magazine — not sent out as being 
possibly too proprietary . 

M 23.0 JANUARY 1980 OVERALL SUMMARY* 

A A summary of the present status of the design and the project. This 
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supercedes all previous reports and 'summaries. 

M 21*. 1 PASCAL MACINTOSH FONT GENERATOR 

The program that generates the proportional font that will probably 
be used on Macintosh. 

Die iiohinere-L'i j>i5TRjBicTgj> coMMiAuiawotss ijBruioi?k' 
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THE MACINTOSH PROJECT 
DOCUMENT 1 VERSION k 

TITLE: INTRODUCTION AND PRELIMINARY CONVENTIONS 
AUTHOR: JEF RASKIN 
DATE: II Sep 79 

1. CHANGE OF NAME 

To avoid using only female names on projects, it has been suggested that each 
major project be assigned the name of a variety of apple. To begin with, 
what once was the "Annie" project is now called the "Macintosh" project. 

2. CATALOGING TECHNIQUE FOR MACINTOSH DOCUMENTS 

As each document pertaining to Macintosh is written, it will be given a 
serial number. A catalog will be kept on a diskette in my files. I 
thertfore request that any document pertinent to the Macintosh project not be 
released until it has been cataloged. This will permit any interested party 
to know what documents have been written, and will allow us to obtain and 
use these documents when necessary. The catalog will also be available in 
printed form upon request. 

3. INTERNAL DESIGN OF DOCUMENTS 

It would be appreciated if each item in each document be numbered, so that wc 
may easily refer to it in other' documents , for example: 

Document ^, Version 3, Item 6.4. 

The heading for each major numbered section will be in all caps, with 
subsections having the first letter of the first word capitalized. 

A. USE OF EDITOR FOR DOCUMENTS 

For improved comciunication, documents should, whenever possible, be prepared 
on the Pascal Editor, with appropriate control characters for Colin's 
formatting program. A typical heading for each document might be: 

•fo • 'Ml. A Page % 

DOCUMENT *** VERSION *** 

THE MACINTOSH PROJECT 

TITLE: *** 

AUTHOR: *** 

DATE: *** 
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This will facilitate building a library of Macintosh documents, and easily 
allow modification and updating of these documents. 

5. The file name of each document shall be of the form Hx.y.text where x is 
the document number and y is the version numb<>r. The catalog Is MO.x.tLxt. 

6. The responsibility for maintaining the catalog shall initially be Jef's, 
but may be assigned to another member of the Macintosh team when appropriate. 

7. Distribution lists and dates by which comments must bo received shall be 
part of the cover letter, and not part of the document. 
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THE MACINTOSH PROJECT 
DOCUMENT 2 VERSION 9 



TITLE: OVERVIEW OF PRELIMINARY AREAS OF CONCLRN 



AUTHOR: JEF RASKIN 



DATE: 11 Sep 79 

1. MARKETING AND AUDIENCE 

1.1 Markets 

1.1.1 Home 

1.1.2 Business 

1.1.3 Scientific 
1.1.^ Industrial 

1.1.5 International 

1.1.6 Educational 

1.1.7 Hobby 

1.2 Contributions this product will make 

1.2.1 This may be the first (unless something else comes along) 
portable computer. It is a personal, not a home computer. If 
this point of view is adopted, then applications, such as hone 
security, where the computer is tied to a physical location, can 
be eliminated. 

1.2.2 This should be a completely self-teaching system. 

1.2.3 Price vs. performance breakthrough. 

1.3 Overall strategy 

1.3.1 vis a vis competitors 

1.3.2 vis a vis other Apple products 

1.3.3 in view of unprecedented large numbers 

1.4 Sales goals 

l.A.l Number of machines over time 
1.A.2 Dollar figures 

1.5 Major risks 

1.7 Gener-'l criteria 

1.7.1 Reliability (works correctly, unbombable) 

1.7.2 Serviceablitity (long MTBF) 

1.7.3 Produceabill ty (designed for the production line) 

1.7.4 Price low, but performance high 

1.7.5 External esthetics excellent (as is our custom) 

1.7.6 Integrity (sufficient testing of all components incl. manuals) 

1.7.7 Maintainability (short time to repair) 

Possibility of self -diagnostic programs; possibility of diagnostic 

through network. 

1.7.8 Documentable (easy to write manuals due to good design, esp. of 
sof tware ) 

1.7.9 Expandable (hardware should not limit range of applications 
unnecessarily) 

1.7.10 Learnability (co-ordinated hardware /sof tware/manual design with 
this constraint in mind at all times) 

1.7.11 Testability (must be testable automatically at the plant) 
1.6 Product life 
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1.9 Profit goals 

2. MAJOR CONSTRAINTS 

2.1 Price constraints 

The initial end-user price, for the minimal machine, should be about 
§500. It is our intent to have a clear path to lowering the price to 
$300 after 16 months, while maintaining profit margins. 

2.2 Weight and size constraints 

2.3 Memory size 

We may wish to fix memory size (and eliminate many possible user hardware 
options) so that software runs on all Macintoshes. Users should not have 
to know about how many bytes of memory they have. This may also allow us 
to produce the machine for less. A user minimun of 32K bytes is suggested. 
This will depend on mass storage considerations as well. 



3. POWER SUPPLY 

3.1 AC supply from the mains 

3.1.1 US 

3.1.2 Foreign 

3.2 Battery supply 

3.2.1 Weight 

3.2.2 Reliability 

3.2.3 Operating time 

It would be nice to obtain 6 hours without having to plug it in. What is 
a minimun that is still useful? 
3. 2. A Potential leakage problems 

3.2.5 Primary or Secondary cells? 

3.2.6 Accessory pack at extra cost for battery power. 

3.3 Solar cells 

To keep perpetual calendar independent of other power supplies? 

A. HUMAN INTERFACE: DISPLAY 

The screen should be soft if possible. Image data compression should be 
considered to conserve memory. 
4.1 CRTs 

A. 1. 1 Home TV 

We should have RS-170 and NTSC compatible output. It should work into 
any standard TV equipment, such as recordt-rs. Both video and modulated 
outputs should be available. If cost constrains, the video would go. 
A. 1.2 Built-in display 

There is the possibility of no built-in display and only a built-in 
printer. The hard-copy device, on the other hand, may be part of 
the display. 

4.1.2.1 Conventional CRT 

A. 1.2.2 Flat CRT 

A. 1.2.3 Projection CRT 

This option has much flexibility, especially in conjunction with a 
photographic hard copy scheme. 
A. 2 LCD display 
A. 3 LED display 
A. A Plasma display 
A. 5 Other technology (e.g. laser) 
A. 6 Size of screens 
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A. 6.1 Number of characters (24 X 80 on CRT, 2 X 80 in portable displ.ny) 

Consider foreign language fonts. 
A. 6. 2 Graphic resolution (suggested minimum: 256 X 256) 
A. 6. 3 Physical size 
A. 7 Color (probably only on external display) 

5. MASS STORAGE 

Some fona of mass storage must be built in. 
5-1 Floppius 

5. 1. 1 Made by us 

5.1.2 From outside vendors 

5.1.3 Very small floppies (2 or 3 inch) 
5.1. A Compatible with any previous product? 

5.2 Bubble memories 

5.3 Cassettes or other tape based storage 

5. A Other technologies 

6. HUMAN INTERFACE: INPUTS 

6.1 Typewriter keyboard 

This is probably a necessity. Atkinson points out that the halves are 
separable. Keyboard should be software mapped if possible (any combination 
should be valid). 

6.1.1 Keyboard layout 

6.1.2 Keyboard electronics 

6.2 Microphone 

6.2.1 As add-on accessory 

6.2.2 As built-in. It may be possible to use speaker as microphone 
although separate microphone probably preferable 

6.3 Audio (this and 6.2 with built-in A/D) 

6. A Photocell (perhaps in conjunction' with a light pen or wand?) 

6.5 Graphic input: joystick, force stick, ball, or tablet 

6.6 Other transducer input: pressure, moisture, temperature etc. 

7. COMMUNICATIONS 

7.1 RS232 

7.2 Phone connector (built-in modem and DAA) 

7.3 Applenet 

7. A Other 

7. A. 1 WWV reciever 

7. A. 2 TV or radio receiver 

7.5 RF link 

7.6 To a paging system 

7.7 IEEE A88 

8. SOFTWARE 

8.1 Major design critera 

8.1.1 "Zero defect" programming 

8.1.2 Excellence of human interface 

8.1.3 Extraordinary testing 

8.2 Initial software offering 

There must be a large initial offering of software. Some examples might 

be 

8.2.1 Checkbook balancing 

8.2.2 Many games (it will be seen as a toy to some purcliascrs) 
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5.2.2.1 Chess 

8.2.2.2 Backgammon 

8.2.3 Word Processor 

8.2.4 BASIC 

8.2.5 Elementary communications protocols 

8.2.6 Instructional programs (e.g. typing, arithmetic) 

8.2.7 Daytimer (can we license use of this namo?) 

8.2.8 Personal 'phone book 

8.2.9 Bulletin board 

8.2.10 Business software 

8.2.11 Telephone simulator (it has a mike and speaker) 

8.2.12 Terminal simulator (also: data entry device) 

8.2.13 High precision scientific calculator 

Note that many of these packages could be applications of a more general 
DBM system with preset data and structure. 



8-3 Cumulative software effort 

8.4 User languages 

8.4.1 BASIC 

8.4.2 APL 

8.4.3 Pascal 

8.4.4 Other 

8.5 System development languages 

8.5.1 Pascal 

8.5.2 Forth 

8.5.3 Assembler 

8.5.4 Other 

8.6 Application development languages 
8.6.1 Pascal 

8.6-2 Pilot 
6-6,3 Other 

8.7 Software security 

8.8 Operating system 

9. MANUALS 

9.1 Self-teaching, on-line manuals 

9.2 Reference manuals 

10. SCHEDULE (very preliminary) 

1 Nov 79 Preliminary -design spec 

1 Mar 80 Final design spec 

1 Jul 80 Engineering Prototype 

1 Mar 81 Prototype for shows 

1 Sep 81 Production in time for Xmas 61 

11. RESOURCES REQUIRED 

11.1 Personnel 

11.2 Capital equipment 

11.3 Supplies 

12. TESTING- 

12.1 In house 

12.2 On a wide range of potential users 

12.3 Of completed systems /programs /manuals 
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13. EXPERIMENTATION 

13.1 With competitive machines 

A. HP-41C 

B. Atari 400 

13.2 With technologies 

A. Attach a touch-panel to an Apple II 

B. Attach a few small-screen CRT's to Apples 

13.3 By programming simulations 

A. Small screen sizes (in terms of resolution and characters) 

B. Simple editors (e.g. my "one command" editor) 
13. A With services 

A. TCA 

B. PCNET 

C. Other "bulletin board" services 

D. DIALOG (Lockheed) BALLOTS (Stanford) 

14. ENCLOSURE AND COSMETICS 

14.1 Design and materials 

14.2 Thermal considerations 

14.3 Choice of colors and case styles 

If this is to be truly a product for the home, shouldn't we offer it 
in various colors? Matched to the 5 standard home appliance colors? 
There is also the possibility of offering options such as a wooden case. 

14.4 Self-protecting case design (lid opens to become display, for example) 

14.5 A handle. 

14.6 If the design is modular, the parts should snap together electrically 
as well as mechanically. 



15. PRINTER AND HARD COPY PICTURES 

15.1 Built-in 

15.1.1 Film based (polaroid or other quick technology) 

15.1.2 Thermal 

15.1.3 Electrostatic 

15.1.4 Dot-matrix impact 

15. 1. 5 Ink jet 

15. 1.6 Laser 

15.1.7 Other 

15.2 External 

15. 2. 1 Letter quality 

Is it silly to try to sell $3000 printers with this machine? 

15.2.2 Portables 

All the possibilities under 15.1 fit here as well. 

15.3 Width of paper (8.5 inch probably) 

16. OTHER PERIPHERALS AND FEATURES 

16.1 AC switched outlets (possibly computer controlled) 

16.2 Speaker (with speech and/or music synthesizers?) 

16.3 Credit card reader or HP card readc-r or both 

16.4 Real time clock (essential) 

Perhaps based on a watch module, always runs. 

16.5 Actuators (e.g. R/C servos) 

16. 6 TTL outputs 
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16.7 Soft "off" switch. 

16.8 Plotter 

16.9 Check reader 

16.10 Video disk (needs interface standards) 

17. THE APPLE TIMESHARING NETWORK 

One of the most powerful uses of Macintosh will become viable only if 
a service such as TCA is available. We will have to consider setting 
up a nation (world?) wide set of local numbers for a number of purposes 
to be covered in another document. A standard protocol will have to be 
promulgated. Study Viewdata, Teletext, Prestcl 

18. FUTURE PRODUCTS IN THE MACINTOSH FAMILY 

Items rejected from consideration as built-in nay be moved here, as well 
as new ideas. 

19. IMPACT ON VARIOUS DEPARTMENTS OF APPLE 

19.1 Purchasing 

19.2 Manufacturing 

19.3 Marketing 

19. 3. 1 Advertising 

19.3.2 Dealers 
19. A Engineering 

19.A.1 System software 

19. A. 2 Applications software 

19.4.3 Analog electronics 
19. A. A Digital electronics 
19. A. 5 Mechanical engineering 

19.5 Publications 

19.6 New Product Review 

19.7 Service 



20. ANALYSIS OF COMPETITION 

20.1 Atari 

20.2 Texas Instrument 

20. 3 Commodore 
20.^ Tandy 
20.3 Japan 

20.6 Calculators 

20.7 Mattel 

20.8 Typewriters 

20.9 Accounting machines 

20.10 Electronic games 

20. 11 Video games 

20.12 Other 



it is assumed, for the time being, that memory will be byte oriented, and 
that the CPU or CPUs will be 8 or 16 bits or some mix of the two. 

21.1 Single or multiple CPU 

21.2 Off-shelf or our own 

21.3 Consider 6809 
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THE MACINTOSH PROJECT 

DOCUMENT 3 VERSION 5 

TITLE: THE APPLE COMPUTER NETWORK 

AUTHOR: JEF RASKIN 

DATE: 11 Sep 79-11 Oct 79 

1 INTRODUCTION 

There are very few potential uses of the personal computer per se in the home 
at the present time. The question "What do you do with it?" still haunts the 
industry. While balancing checkbooks, playing chess and writing letters are 
all viable uses, it is likely that a true mass market cannot be supported on 
the basis of such applications. In the face of this problem, most 
manufacturers, seeing the hobbyist and technophile markets becoming 
saturated, have turned to marketing business systems. The business systen 
market is big and legitimate opportunities abound there, but the volume 
can never be as large as it would be for an item that goes to consumers in 
general . 

There is a feeling in the industry that telecommunications will become a key 
part of every computer market segment, and this is increasingly becoming so. 
Many experiments and a few successful services are in operation. Aside from 
long-standing timesharing systems such as GE and TYMSHARE, we have the ARPA 
net, Xerox's internal Ethernet, TCA (alias "The Source"), Prestel, the MECC 
network, and many others. Appendix 1 lists a few commercial services that 
may be of interest to us. A set of "underground" message centers have come 
into operation, for example, the PCNET. There are also a few other 
individuals and small groups that set up a microcomputer with an autoanswer 
modem and some software that allows users to leave and retrieve messages. 

According to "Computer Retailer", Radio Shack and Western Union are 
working out some cooperative venture involving WU's "Mailgram" service 
whereby Radio Shack computer owners can exchange messages. 

It is clear that one answer to the question "What do you do with it?" will 
probably be: "I use It to send birthday greetings to Aunt Tillie." More to 
the point there are a number of easily forseen potential uses for a networh 
of personal computers. What is more exciting is that, as has happened with 
the computers themselves, there is the potential for many 
unf orseen applications. 

1.2 POSSIBLE APPLICATION AREAS 

Many applications have been put forward. Among them are: 

Time of day; News (with a boolean query data base); Stock Market (as per what 
we arc already doing); Soap Opera Condensations; A guide to local TV programs 
(what's on at 9:00PM?, any westerns tonight?); Message forwarding and 
distribution; Fax transmission (special case_of message: the bits are 
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Interpreted pictorially ) ; Weather Travel Info; Phone directory; Local, area 
or national business directory; Apple program distribution channel; Apple 
update distribution channel; Access to Lockheed's DIALOG or Stanford's 
BALLOTS systems or similar ones; A better way to answer user questions than a 
phone based hotline at Apple; Library of Congress card catalog; Legal 
precedents; Program exchange; Educational courses; Educational testing; 
Voting; Computer program exchange; Advertising; Computer dating; Tax 
information; Banking (another step to the cashless society (If taxes don't 
reduce us to a cashless state first)); Access to larpc data storage for 
individual needs; Access to computer power (i.e. timesharing); Insurance 
quotes; Credit infonnation (what is available: what is my status); Market 
research; Purchasing information (who has the cheapest refrigerator model 3A- 
aa within 10 miles); Plane schedules; Dictionary and Encyclopedia searches. 

The list is potentially endless. Most come under one heading: Access to a 
Data Base. A few come under the heading: Communication. The remaining 
handful are miscellaneous. 



The point of this list is that telecommunications provides a host of answers 
to the "What .do you do with it?" question. Wliat follows is a proposal for 
supplying customers with this kind of service. 

2. IMPLEMENTATION OF AN APPLE TELECOMMUNICATION SYSTEM 



2.1 SOME NON-TECHNICAL PROBLEMS 

It is clear that setting up any kind of independent communications network 
runs afoul of many bureaucratic agencies, and would alarm many companies now 
in the communications industry. For these reasons alone, it is best to use 
existing communication channels. The problems of being a user of such a 
system are probably less than the problems of being in the industry, 
document M 12 discusses some of the potential problems with being a 
user of the telephone network. 



2.2 NEED FOR PROMPT AND AGGRESSIVE POLICY 

Apple cannot possibly create the data bases that are required to make this 
proposal viable. As we have done with Dow Jones, we will have to negotiate 
access for our users to existing data bases and services. Our success in 
this field will depend on aggressive and prompt action to secure (possibly 
exclusive) use (with resptct to personal computers) of what we see as the 
most Important services. 



2.3 TELEPHONE BASED SYSTEM 

The most universal bidirectional data path to homes in this country is the 
telephone. We presently have the technology to provide a low-cost compute 
with a 300 baud modem. Since the Carterphone decision, access to the 
telephone network has been assured (as least as much as anything can be 
assured in the communications field). There are a number of ways of 
providing a universal service through the telephone. 



2.3-1 MANY LOCAL NUMBERS 
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The time sharing services have chosen to have many regional centers or data 
accumulation points. Dow Jones, for example, provides many local numbers. 
There are some disadvantages to this scheme: it requires publishing a book 
of telephone numbers, and some subscribers have to make toll calls if they do 
not live in or very close to a major population center. One advantage of 
this system is its redundancy. 

2.3.2 A TOLL-FREE NUMBER 

With one (or perhaps two) toll-free numbers, every phone in the country can 
have access to a central computer installation or what 1 will call an A- 
node (explained below). This has the psychological advantage of making 
access to the service appear "free". The number is easily advertised, again 
encouraging usi;. Research will have to be done to determine the expected 
density of useage and just how practical such a system would be. 

2.4 LIMITED OR UNIVERSAL ACCESS 

Can we, or should we try to, limit access to owners of Apple products? If 
we allow access to anybody with proper equipment (probably any computer or, 
perhaps, even some terminals) can we legally build in advantages for Apple 
owners? For example, the only software available will be for Apples. If 
we use some technological means of permitting only Apples into the service, 
this would require special hardware and/or software in future products, and 
might not be retro-f ittable to the Apple II series. 

It is my feeling that access should be universal, with some unique services 
for Apple owners. Greg Justice is devising an inexpensive modem for 1200 
baud half duplex telephone line communications. This might be an Apple ex- 
clusive. 

2.5 TECHNICAL PROBLEMS 

If credit or any other sensitive information is involved, security measures 
will be necessary. Security problems are inevitable in any case since we 
wish to bill our customers for their useage of at least some parts of the 
service. Use of other parts may be paid for by the suppliers (e.g. when the 
service amounts to advertising) and thus «;eem free to the user. D. L. 
Denning, in her article "Secure Personal Computing in an Interactive 
Network" (CACM Vol. 22, No. 8) suggests a method for implementing security 
where the users, rather than the network, have control of security. While I 
question the implementation suggested there, the idea that security can come 
from the user's side is a good one. 

Protocols will have to be carefully defined, simple enough for naive users, 
yet powerful enough to cope with any data base to which we subscribe. There 
may have to be, as with the PCNET protocols, levels of access from the 
beginner's character stream to the expert's auto-path-f inding data 
compressed packet. If we are fast enough, the protocols we design may be- 
come a dfc facto standard. 

2.5.1 INTERFACIAL SOFTWARE 

One way of easing the user's problem at accessing the many data bases that 
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exist would be to provide, as we have begun to do for the Dow Jones services, 
programs Chat Iron out the difficulties of using the various services, so 
that they all appear relatively uniform and easy to use. 

This would become an ongoing software project for Apple, and would represent 
the least Involved method of providing access to data bases. It would not 
provide a universal message transfer system, however, and thus possibly 
decrease the desirability of the Macintosh system. It would also not provide 
a single telephone number for all services, and might require each user to 
have multiple contracts. Users would not be encouraged to try more services 
as much as they might if the services were more consolidated. 

If we adopt this approach, we will have to define a set of unified protocols 
for accessing data bases — of diverse kinds. This is no easy task, since most 
of them were designed quite independently. 



2.5.2 ESTABLISHING A-NODES 



The next level up in user convenience from providing software for stand-alone 
Apples to facilitate access to each data base would be to provide an A- 
node, or data concentration center or centers. This A-node would be accessed 
through a single protocol from the user's computer, and then the A-node 
would initiate and monitor (for billing purposes) the connection with the 
various data base, systems. This process would insulate the user from having 
to be familiar with each different data base's telephone number and 
protocols. 

The A-node would also be a message storing and forwarding center. 
3. IMPLICATIONS FOR THE MACINTOSH PROJECT 

This proposal grew out of attempting to answer the "What do you do with it?" 
question. Without some sort of network/data base service the question is 
going to be much harder to answer. 1 am proposing here that the creation of 
Apple communications, in some form, is part of the definition of the 
Macintosh computer project. 



A. IMPLICATIONS FOR APPLE COMPUTER INC 



We don't think of the te-lephone company primarily as a manufacturer of the 
little $40 things with dials or pushbuttons that we have in our homes and on 
our desks. The Implications of this proposal, at one extreme, is that Apple 
will be seen, in the future, not so much as a builder of hardware, but as the 
purveyor of a service that interpenetrates the telephone network, and 
provides information. 

On the other extreme, Apple will be in its present position, adding access to 
data bases on a piecemeal fashion. Message transfer will not become a 
useful function unless somebody else happens to start a message system that 
is universal enough and otherwise meets our needs. 1 do not like trusting to 
luck. 

The high cost to Apple of having done our early software piecemeal and in an 
ad hoc manner should act as an example of why we should not let our 
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communications effort be similarly scattered. 

The intermediate approach, using the A-node, may be the most practical. At 
least its requirements are not excessive in terms of hardware or software, 
and it can start as a mere message center (for the whole United States at 
first) and then grow as we contract with providers of data bases and brin^ 
them on line. 

This proposal, if it is carried out, will represent an additional direction 
for the company. We will not be alone in the personal computer 
communications field, we can strive to be the best. Certain vested interests 
may be threatened by an Apple communications system, and there may be 
unpleasant pressures. 



5. SUMMARY 



It is my opinion that the A-nodes provide a practical solution to a good 
portion of the "What do you do with It?" question. If, in the next few 
months, a clear alternative occurs (such as might be provided by the growth 
of a company such as TCA) we should consider it. We must do something in the 
way of providing communication between Apples in locations distant from each 
other, and communication with sources of information. 

Mike Markkula has suggested that this may be an undesireable path in that 
others will be doing it, and we can use their services. He further suggested 
that we establish a protocol early on, and publish it in order to obtain a 
leadership position. 1 agree with trying to establish the protocols early, 
and promulgating them, but I think we must also press ahead with a detailed 
study of the costs and benefits of our own system. 

I am concerned that many of the existing services are either too poorly set 
up, or don't have the breadth of vision required. We may also need growth 
rates not anticipated by the existing companies. If we do not have a 
communications network to use, then what will people do with the million 
Macintoshes we wish to produce? 
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APPENDIX 1, SOME SOURCES OF DATA BASES AND COMMUNICATION'S 



Telecomputing Corporation of America 
1616 Anderson Road 
Mclean, Virginia 22102 

A service designed for the personal coinputer user. 
"The Source". Advertises in Byte. 



It is comnionly called 



Computserve , Personal Computing Division 
5000 Arlington Centre Blvd. 
Columbus, Ohio A3220 

Tradenamed "Micronet", it is a less ambitious project than The Source. 
Advertises in Byte. 



SDC Search Service 
2500 Colorado Ave. 
Santa Monica, CA 90406 

A commercial service with no special attention to microcomputer users, 
mentioned here because it has a wide range of services. 



The Information Bank 
171S Route 10 
Parsippay, NJ 0705A 

A news service to the New York Times, Wall Street Journal, Business 
Week and some 60 other publications. No special attention to micro- 
computer users. 

Lockheed's Dialog data base and Stanford's BALLOTS would be fine 
candidates, along with our existing Dow Jones service. All in all, there are 
many services available. A listing of such services appears in the 
Applications Directory of The Association of Time Sharing Users, Inc., P.O. 
Box 9003, Boulder, CO 80301. Almost all the services listed there provide 
economic, stock and commodity, market or demographic information. The two 
two most interesting from that list are shown above. Thanks to Tom Whitney 
for showing me this catalog. 



M 3.5 Pago 6 F/Aff^__ 

■■RaskinDoc003 1 01 9.PICT" 1 27 KB 2000-02-27 dpi: 300h x 300v pix: 2027h x 3070v 



Source: David T. Craig 



Page 0021 of 0174 



Jef Raskin Document # 003 -- Macintosli Project Memos (February 1980) 



The il Macintosh Project: Selected Papers (14 Feb 1980) 



10 



of 171 



THE MACINTOSH PROJECT 
DOCUMENT U VERSION 1 

TITLE: DESIGN CONSIDERATIONS FOR AN ANTHROPOPHILIC COMPUTER 
AUTHOR: JEF RASKIN 
DATE 28-29 May 79 

(This document was written before the Macintosh project was operating under 
that name, and was still called "Annie". This note was written as an observer 
at that time not directly involved in the project. (Comments in brackets have 
been added on Oct. 11 79)] 

This is an outline for a computer designed for the Person In The Street (or, 
to abbreviate: the PITS); one that will be truly pleasant to use, that will 
require the user to do nothing that will threaten his or her perverse delight 
in being able to say: "I don't know the first thing about computers , and one 
which will be profitable to sell, service and provide software for. 

You might think that any number of computers have been designed with these 
criteria in mind, but not so. Any system which requires a user to ever see 
the interior, for any reason, does not meet these specifications. There must 
not be additional ROMS, RAMS, boards or accessories except those that can be 
understood by the PITS as a separate appliance. For example, an auxiliary 
printer can be sold, but a parallel Interface cannot. As a rule of thunb, if 
an item does not stand on a table by itself, and if it does not have its own 
case, or if it does not look like a complete consumer item in of itself, then 
it is taboo. 

If the computer must be opened for any reason other than repair (for which our 
prospective user must be assumed incompetent) even at the dealer's, then it 
does not meet our requirements. 

Seeing the guts is taboo. Things in sockets is taboo (unless to make ^ 
servicing cheaper without imposing too large an initial cost). Billions o. 
keys on the keyboard is taboo. Computerese is taboo. Large manuals, or many 
of then (large manuals are a sure sign of bad design) is taboo. Self- 
instructional programs axe NOT taboo. 

There must not be a plethora of configurations. It is better to offer a 
variety of case colors than to have variable amounts of memory. It is better 
to loanufacture versions in Early American, Contemporary, and Louis XIV than to 
have any external wires beyond a power cord. 

And you get ten points if you can eliminate the power cord. 

Any differences between models that do not have to be documented in a user's 
manual are OK. Any other differences are not. 

It is most important that a given piece of software will run on any and every 
computer built to this specification. There must be no differences between 
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machines whether In terms of I/O, speed, memory size, configuration, or 
possible accessories. 

(Speaking of accessories—off hand, the only accessory that I can eee bolnt 
sold is a printer. If this can be built in (on EVERY machine) then there is 
little cause for ever having accessories at all. This is optimal.) [So far, 
price constraints and the pervasive id. a of a network have changed this a 
bit.] 

It is expected that sales of software will be an important part of the profit 
strategy for the computer. 

If it is anticipated that fewer than 100,000 of these anthropophil ic 
computers will be sold in a 2 1/2 year pc-riod, the project should not be 
undertaken. 

A CANDIDATE FOR SUCH A MACHINE 



The computer must be in ore lump. This means, given present technology, a A 
or 5 inch CRT (unless a better display comes along in the next year), a 
keyboard, and a disk integrated into one package. It oust be portable, under 
20 lbs, and have a handle. "Apple V" would not be a bad handle. It should 
fit under an airline seat. It would be best if it were to have a battery that 
could keep It running for at least two hours when fully charged. 

Some things are easy to choose. Performance, in the usual computer-science 
sense, is not too critical. An 8-bit CPU. eight 6AK RAM chips, one RS-232 
Interface, a telephone jack, and some 200K bytes on the diskette would be 
fine. There must be a clock-calendar that is battery powered. 

Other things are harder to pick. Clearly, there should be BASIC available. 
And there should be some underlying system language, reachable through BASIC, 
so that OEM software houses (and our own programmers) can do what's necessary. 

One very small. Inexpensive and compact language suitable for this 
application is FORTH. Having to use an external development system will 
hamper the growth and sales of the machine. 

The end-user cost for this machine should be $500 or less, to be sold early in 
1982 (or, better still, by Christmas 1981). 

THE ACCESSORIES 

Printers. Maybe. 

SOME USER-VIEW SOFTWARE CONSIDERATIONS 

The system must not have modes or levels. The user always knows where he or 
she is because there Is only one place to be. 

THE BASIC 

The language should be pure interpreted. All system commands should be 
embedded In the language, all statements in the language must be commands. 
The program should be user-interuptable (and process interuptablo ) and 
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resumable even after being changed. Anything that can be done by the user can 
done by the program and vice versa. 

Consistency Is important. All names, whether file names or variable names or 
array names... should have the same syntax. Wherever a constant can be used, 
60 can an expression be used. Strings should not behave differently than 
other arrays. All arrays should be dynamically allocated. 

Declarations are taboo. 

Or, rather, requiring declarations am taboo. 



TOYS 

Graphics must be in the language as well as sound generation via an internal 
speaker. The present set of sound-generating chips should not be considered. 

Cursor controls should be on the keyboard, and should be used where graphic 
input is called for. The Apple III keyboard is not far from Ideal. 

RS-THIS AND RS-THAT 

Standard RS-170 video output is not a bad idea, especially if it is to be used 
in schools. That was five two letter words in a row. But video output is not 
necessary. 

Actually, neither is an RS-232 port. But 1 have a suspicion that it might be 
nice. Perhaps the phone jack, having two extra wires as it does, could become 
an RS-232 minimal (3 wire) port with an adapter. The minimum number of holes 
in the case through which fingers, screwdrivers (either metallic or liquid), 
EMI or earwigs can crawl is to be desired. I guess that adapters are OK as 
accessories. 

Ye same olde 'phone jacke couldst be into service yprest, forsooth to 
accomodate divers keyboards, sych as yon organ hath. 

The utility of the computer is vitally enhanced if the 'phone jacke had some 
personae with whom to talk, to wit, a network is an essential part of the idea 
of Annie. And 1 don't mean ABC, CBS, PBS, NBC and Mutual. 

SUMMERY 

That means fair, warm weather, just after spring. 
SUMMARY 

Let's make some affordable computers. 
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THE MACINTOSH PROJECT 
DOCUMENT 5 VERSION 1 

TITLE: PRELIMINARY COST INVESTIGATION 
AUTHOR: JEF RASKIN 
DATE: 27 Sep 79 



1. COST 

One of the primary goals for Macintosh is that it should sell for $500 — with 
the possibility of reducing the cost to $300 with increasing quantity. 

By our present selling price versus manufacturing cost ratio this means that 
Macintosh should cost us about $125 to build. Consider this highly speculative 
cost breakdown (assuming a case and board about Apple H size) 



PART 1981 


COST 


POTENTIAL 


COST 


keyboard 


20 


10 




CPU 
6502 
6809 
68000 


U 
12 
90 


3 
7 
65 


minimum cost 
likely candidate 
upper end 


6AK bytes 


80 


50 


8 6AK RAf-IS ((? $10 and 


video chip 


15 


10 




modem chip 


20 


15 


with DA A 


case 


15 


5 . 


dtjponds on size 


power supply 


15 


10 




p c board 


12 


8 


depends on size 


misc 


25 


15 


connectors, fasteners 


SUBTOTAL 


214 


130 


basic electronics cost 


build, test 


10 


2 


design for automation 


(this last category 
it is included even 


has much room for lowering cost, and thus 
though it is not part of parts costs.) 


disk drive 


80 


35 




display 


AO 


20 
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printer 50 25 

TOTAL 346 212 

For this very minitnal csLimate we assume a 6809 processor as a passable 
compromise between power and cost. It is readily available, allows our video 
techniques, requires few support chips, and is relatively efficient in terms 
of compiled code size. 

At a 4X selling cost vs our cost ratio there is no way, even without disk, 
printer or display, that we could get below $850 given these prices. Fully 
loaded, the sellinp price may well be $U00. And there are many itens 
omitted from this list, and the costs are probably optimistic. At the 
minimum prices that I can forsee, the base machine might be able to sell for 
$520. The full package for $850. 

These costs may not be spot on, and the 4X multiplier is not fixed, but these 
are indicative ball-park figures. While the minimum price of $520 might look 
close to our goal, remember that it Is extremely optimistic, includes no 
peripherals, and should (to meet our goals) be well under $300 (our 
"eventual" figure). 



1.1 TWO POSSIBLE DIRECTIONS 

Either we can continue the design of Macintosh with the present desiderata, 
and abandon our price goals, or we can keep the price celling and see what 
kind of machine we come up with. It seems that the higher priced machine 
that falls out of this analysis is not much different from a price reduced 
SaraCS Therefore we will examine what we can do for a $500 selling price 
llmit.V^^«TSL 

1.2 THL MACINTOSH 500 

One item on which we should not compromise is a keyboard. 
$ 20 

Assume, for the purpose of having truly adequate software, 6AK RAM 
$ CO 

We build our own video and modem chips 
$ 35 

Keeping the case quite small, it and the PC board might be lowered to 
$ 25 

If things are kept small, the power supply mif,ht drop to 
$ 12 
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Add 



$ 18 

for miscellaneous, and a 



$10 

CPU to bring us to a nice round total of 



$100. 

A machine with no peripherals vd.ll have 
32K ROM with a word processor and BASIC 
to 6809 code). This adds 



to have some ability in ROM. Assume 
(both written in Pascal and compiled 



$25 

or so. This, inflated by details and committee embellishment, gives us a 
chance at a $500 computer. Note the following facts: 



A. No display is included 

B. No disk is included 

C. No printer is included. 

The solution to providing these is as add-ons that attach both me 
and electrically to the basic Macintosh product. 
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THE HACINTOSH PROJECT 
DOCUMENT 6 VERSION 2 
TITLE: GENERAL CRITERIA 
AUTHOR: JEF RASKIN 
DATE: 28 Sep 79 
1. MAJOR CONCEPTS 

The most important goal (after the operational goals set out in Document 
3), in tny opinion, is for this computer to have a selling price of $500 or 
less. If it is significantly more expensive than this, there will be 
little to differentiate it from some of our other personal computers. 
Macintosh is designed to be much easier to use than existing computers, and 
it must be provided with a range of pre-programmed applications that the 
average person will find alluring. 

1.1 PACKAGING 

The package must be compact (13" width, 13" depth, 5" height maximums), 
lightweight (under 10 lbs), and robust (it would be desirable that a three 
foot drop onto a solid floor cause at most cosmetic damage). 

Since the cost analysis seems to indicate that a display, a disk, or a 
printer cannot be part of the package (Document 5), these and other 
peripherals should be attachable to the basic unit. It is imperative that 
Macintosh not evolve into a tangle of wires. Therefore it is 
probably necessary for each peripheral to attach to the basic unit both 
mechanically and electrically, allowing a daisy-chain bus and therefore an 
open-ended number of peripherals. Figures 4, 5 and 3 show some possible 
physical arrangements. The IEEE 488 bus might be considered as part of the 
definition for this application. 

This would allow the basic computer, with video, RF, phone and one RS-232 
outlet to have a very attractive price, with relatively inexpensive 
matching peripherals. 

Markkula's intriguing suggestion that the units be connected by radio links 
rather than physical ones should also be Investigated. It may be less 
expensive than the present suggestion. The problem of FCC regulations and 
the need for separate power supplies remain open questions. 

The modular packaging concept allows us to offer, for example, a variety of 
displays as technology permits. A strong defeciency of modular packaging 
Is that wc would have to write software that can work in a variety of 
configurations. This greatly increases the cost to produce software, and 
presents marketing and diagnostic problems as well. 

1.2 PORTABILITY 



M 6. 2 Page 1 

■'RaskinDoc003 1 026.PICT191 KB 2000-02-27 dpi: 300h x 300v pix: 2062h x 31 16v 



Source: David T. Craig 



Page 0028 of 0174 



Jef Raskin Document # 003 -- Macintosh Project Memos (February 1980) 



The * Macintosh Project: Selected Papers (14 Feb 1980) 12L- of 171 



Aside from the size and weight constraints, it would be especially 
beneficial if the unit could be used portably. One of the add-on packages 
could be a battery pack with, if necessary, an inverter. The power supply 
Itself could be In one of the add-on packs, giving the user the" choice of 
an AC supply or a DC supply and charger. 

If no display Is built in, the user has the option of carrying a smaller 
package, and using a home TV. Most home black and white TVs can support 6A 
characters per line. I have tested this using the Poly 88 computer, which 
is a 66 character, upper/lower case machine. 



1.3 LEARNABILITY 



Macintosh must be easy to use. The keyboard should be typewriter-like, 
with no computer jargon on the key-tops. Nonetheless, it must be able to 
generate the entire ASCII code-set. But it will be the design of the 
software and manuals that will have the greatest effect on the ease with 
which the computer will be used — coupled with the expectations generated in 
the user by our advertising and the current personal computer milieu. 

A separate set of documents will cover software and manual design, and yet 
another will have to discuss advertising strategy. 

\.U SERVICEABILITY 

Macintosh must be serviceable: Wll Houde would like to give a one year 
unlimited warranty with the machine. What is required Is a long MTBF. In 
the presence of the strong price constraint we cannot merely take the path 
of high quality components for whatever design we come up with — we must 
restrict the ambition of the design so that we can afford to build it well. 

The modular approach taken above is both a help and a hindrance to 
reliability: each of the parts will be designed independently., and to 
different restraints, they can even have different warrantees. On the 
other hand, there Is now a set of electrical and mechanical connections 
that otherwise would not be there. 

Since the signal may pass through a number of boxes, a failure in an 
Intermediate module might affect the operation (and the diagnosis) of 
another unit. 

A single-box design puts many electronic and mechanical pieces together, 
thus significantly increasing the probability of a failure of the whole 
device In a given time period. It can be argued that if any of the modules 
fall in a modular design, any program that uses that module cannot run 
anyway, and the entire machine is lost In spite of the modularity. On the 
other hand, it Is easier to manage the shipment and servicing of a single 
box. The software reliability of a single-box system is also greater. 

Serviceability is also a function of the quality of the manuals. A 
separate document will discuss the on-line and off-line manuals 



1.5 MAINTAINABILITY 
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Ease of repair is a function of simplicity, accessibility, modularity and 
the design of diagnostic software and procedures. Aside from having the 
design monitored by our service and repair personnel, the designs bcinc 
considered seem Inherently maintainable. We should consider setting up a 
system programming effort to write a set of diagnostic routines as part of 
the Macintosh project. 



1.6 PRODUCEABILITY 



At all times, our production engineers will be consulted on 

the design of the computer. The fundamental design should be sinple board, 

with an integral keyboard if possible. 



2. SOFTWARE DESIGN CRITERIA 



2. 1 LEARNABILTY 

There Is one quality that software can have to inprove learnability: 
consistency. That one attribute is probably more important than the 
details of what we are consistent about. Consistency also minimizes the 
size of our manuals, and decreases the time it takes to write and test 
software. It increases the time it takes to design a system, since all 
aspects of the software, from command level to every application program 
must be considered in setting up the design parameters. 



2.2 MAINTAINABILITY 

All the software for Macintosh must be written under the same system and in 
the same language. The operating system will probably be a descendant of 
SOS, and the language will probably bePascal. (This should not prejudice 
the choice of user languages). 



2.3 RELIABILITY 

We expect that we shall sell hundreds of thousands of Macintosh computers. 
It should be a guiding principal that software goes out as the result of a 
program designed in the spirit of the NASA "zero, defect" program since It 
will become uneconomical to upd'ite progiams once they are sold or delivered 
as part of the system. 
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THE MACINTOSH PROJECT 
DOCUMENT 7 VERSION 7 

TITLE: A MODEL OF MEMORY VS. DISK CHOICES 
AUTHOR: JEF RASKIN 
DATE: 2-4 Oct 79 

1. A PATH TOWARD THE DESIGN 

My investigations start off with the human input, the keyboard, and an 
application, personal (as opposed to business) word processing. With this 
starting point, we form a branching trail through the woods of 
possibilities. 

1 . 1 THE KEYBOARD 

Macintosh will have a typewriter styled keyboard with embedded numeric pad 
(as on the HP 2621). No separate key pad should be provided for three 
reasons: it shaves a bit off the cost, it makes the package physically 
smaller, it looks less forbidding. Such a keyboard is excellent .for word 
processing, and we will first explore system requirements for this 
application. Aside from the embedded numeric pad, the keyboard layout will 
not differ much from Sara^ excellent design. 

^ ApHellE 

The cost of such a keyboard will be about $20. 

1.2 WORD PROCESSING 

A practical word processor has either a buffer of over 20K bytes for user 
input, or a mass storage device whose operation is totally invisible. Since 
an overflow of the internal buffer can happen while a person is typing (even 
in the middle of a word), the time that the keyboard does not respond while 
the system is squirrelling away the buffer should be under 0.1 second. You 
don't want the system breaking the user's concentration by upsetting him or 
her with random pauses. 

Since this application places some restrictions on storage, there are (at 
least) two ways of going about it: supplying sufficient random access 
storage, or a fast mass storage device. 

1.2.1 SUFFICIENT RANDOM ACCESS STORAGE SOLUTION 

This can be provided through RAM, or through some other technology ^s 
bubble memory. For our application, we have said we need a minimum of 20K 
bytes for the user's area (there being no real upper limit on how much user 
storage can be put to use). In addition wo need the word processing 
software, and the underlying operating systeo. Here the path forks again, 
as the amount of storage required for the software depends on 'he CPU 
chosen. If the CPU is a Lisa type, then the software will probably require 
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about lOK bytes, and the system need only have 32K bytes altogether. If the 
CPU has the power of, say. a 6809, then the interpreter will require perhaps 
8K, the word processor about lOK and the operating system around 8K bytes. 
This CPU would require A6K bytes. If 16K bytes of RAM cost $25, 4a 6809 
costing about $10) the Lisa type processor would have to be under. $35 to be 
cost effective in this application. 

1.2.2 FAST MASS STORAGE SOLUTION 

In the Macintosh time frame, the only viable mass storage is floppy disks. 
Hard disks are too expensive, and their media is not removable. Bubbles 
seem to be coming along a bit too slowly. Nonetheless, we will keep our eyes 
open. 

While floppies are usually considered to be too slow for our application, 
they can be fast enough if we go to a multiple processor system so that 
spooling can go on in parallel with word processing. Assumming (and here is 
another branch in the path) 24 lines of 64 characters (1536 bytes) there 
could be a minimum 2K buffer which both refreshes the screen and is the text 
buffer. When it scrolls off screen. It scrolls onto a floppy. The few 
hundred extra bytes gives the system enough time to start up the disk 
drive . 

Searches might, with this kind of scheme, be a bit slow and noisy. There are 
many trade-off points, the buffer can be expanded to 4K, or 8K, or larger, 
and the disk useage goes down with each Increase in memory. A mathematical 
model can be built for this situation. 

1.2.2. 1 THE MODEL 

Assume that the user has M kilobytes of memory at a cost of $b per kilobyte, 
a floppy (and associated processor and support circuitry) which costs $f with 
a transfer rate of T seconds per kilobyte, and a processor and memory that 
permits a search for a pattern match at a rate of G seconds per kilobyte in a 
document of D kilobytes (D*G seconds for the complete document when the 
entire search Is in memory). We can now examine how many kilobytes per 
second of searching a system can achieve with disks, and what the cost is for 
dlflarent memory/disk ♦-radcoffs. 

If 

D <= M 

then no disk accesses are required, as the entire document fits in memory so 
that the time required for the search Is 

D*G 

at a hardware cost of 
Mb. 

In the case 
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D > M 

where there Is insufficient main memory for the entire document, disk 
accesses occur. Assuming again a search through the entire document, the 
number of accesses (less one) is S which can be calculated by S - TRUNC 
(D/M). The time for reading in each segment except the last is L + M*T, 
where L is the latency time of the disk. The last segment is of length D - 
S*M (which is if D MOD M >= 0). For the total number of accesses the time 
is S*(L4fl*T) + L + (D - S*M)*T. To this is added the in-memory search tine , 
D*G. Simplifying the resultant expression, the total search time is 

D*(G + T) + L*(S + 1) 

which is easily interpreted in this form: the first major term represents the 
total time for transferring and searching the document, the second term 
represents the sum of the latency times. 

The cost of the hardware is the memory cost plus the floppy cost 
(M*b + f). 

This model must be modified where, as on our floppies, the latency time is 
significantly lower if the disk Is already spinning. In this case 

L - U 

where U is the motor-starting latency and 
L •= V 

where V is the rotational plus average seek time latency. Usually the tine V 
is included in U In the motor-starting case. There is also a fixed shut-down 
time, W. 

The time for a search through a complete segment is (D*C)/(S + 1), so that if 
this time is greater than or equal to W, then 

L - U 

otherwise 

L = V + W - ((D*G/(S +1))) 

which is the rotational plus seek latency, plus what is left of the motor-off 
time after the search is complete. This ignores the very small program 
overhead in the spooling algorithm. 

A concrete example in the late 1981 time frame might have the floppy (and 
associated hardware) at $55, and memory at $1.60 per kilobyte. Assume that 
the transfer rate averages 0.1 seconds per kilobyte (this is the present 
Apple II 16 sector speed), and that a search in memory takes .006 seconds 
per kilobyte (this is about the speed at which Sara will work). Assume 
further that the latency U is 1.0 seconds, and the average latency V is 0.15 
second (on the Disk II, the average rotational latency is 0.1 second, and a 
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crack to adjacent track seek about 0.01 second). 



The reader is directed to the programs M 9 and M 10 in this series o 
documents to play with these values. 
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THE MACINTOSH PROJECT 
DOCUMENT 8 VERSION 1 

TITLE: REPLY TO JOBS, AND PERSONAL MOTIVATION 
AUTHOR: JEF RASKIN 
DATE: 2 Oct 79 

1. TODAY STEVE JOBS SAID: "DON'T WORRY ABOUT PRICE. JUST SPECIFY THE 
COMPUTER'S ABILITIES" 

It is impossible to Tnerely start with the desired specifications: it is too 
easy. We want a small, lightweight computer with an excellent, typewriter 
style keyboard. It is accompanied by a 96 character by 66 line display that 
has almost no depth, and a letter-quality printer that also doesn't weigh 
much, and takes ordinary paper and produces text at one page per second (not 
so fast so that you can't catch then as they come out). The printer can also 
produce any graphics the screen can show (with at least 1000 by 1200 points 
of resolution). In color. 

The printer should weigh only a fraction of a pound, and never need a ribbon 
or mechanical adjustment. It should print in any font. There is about 200K 
bytes of main storage besides screen memory and a miniature, pockctable, 
storage element that holds a megabyte, and costs $.50. in unit quantity. 

When you buy the computer, you get a free unlimited access to the ARPA net, 
the various timesharing services, and other informational, computer 
accessible data bases. Besides an unexcelled collection of application 
programs, the software includes BASIC, Pascal, LISP. FORTRAi;, APL, PL\1, 
COBOL, and an emulator for every processor since the IBM 650. 

Let's include speech synthesis and recognition, with a vocabulary of 3A,000 
words. It can also synthesize music, even simulate Caruso singing with the 
Mormon tabernacle choir, with variable reverberation. 

Conclusion: starting with the abilities desired is nonsense. We must start 
both with a price goal, and a set of abilities, and keep an eye on today s 
and the immediate futurc'-s technology. These factors must be all juggled 
s imultaneously . 

2. WHY TIME COST ARE OF THE ESSENCE 

In an article for IEEE Computer , Raskin and Whitney argued that the 
difference between a computer and a programmable calculator was the iorv^or s 
ability to handle text. The HP-41C, at $295, is a (weak) computer. Ohio 
Scientific has announced their C4P computer, which at $698 looks like a good 
buy". In fact, it has 8K of RAM. and the cost to get one disk and an 
additional 16K is $1000. Nonetheless, I would like to see Apple have a 
computer In the $500 class, and of better value than the competition s, as 
soon as possible. 
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When a person is making a decision to buy their first computer, they do not 
know enough to go much beyond the advert ismcnts and the bottom line. Since I 
believe the computers we sell, and are going to sell, are better and better 
supported than the competition, I would like to see a person be able to buy 
an Apple quality product for a low entrance price--wlth accessories available 
to bring it up to the level of computational power that we know is necessary 
before the personal computer is truly a satisfactory tool. 

We nay not be able to achieve a mass market unless we can educate people by 
selling them a system that we know they will want to expand, and letting then 
learn why they need mass storage, printers and all the rest. This is one of 
the main ways that Macintosh should be different from Sara and Lisa. 

In the light of the above mentioned machines, the $795 Pet, and $698 TRS-80, 
the Atari 400, and some other machines now coming along, it is clear that we 
need a product that looks (and is) competitive. We can (and do) among 
ourselves point out the flaws from a user's point of view in the competitor's 
product — it is hard to see how anybody could put up with a TRS-80 if they 
have had much experience with an Apple II (At 16K the difference is only $200 
between a Level II TRS-80 and an Apple II Plus). The fact is that a random 
customer will not have the opportunity to make the comparison beyond seeing 
the $200 difference. (That and Radio Shack's 6,000 or so outlets). 

Therefore let's use our superior engineering, software, documentation, 
production, service and marketing abilities to produce an excellent low-cost 
computer. I am not suggesting we copy and follow our competition, I suggest 
that we leap-frog them. 

My personal interest in small computers is evangelical, that's why I tackled 
manual writing first. That's why I fought for Pascal, that's why I work for 
Apple. My message is that computers are easy to use, and useful in everyday 
life, and I want to see them out there, in people's hands, and being used. 
My purpose will not be accomplished unless Apple continues to be one of the 
leaders in terms of pure numbers of customers. I don't like being second or 
third, I would rather Apple be number 1. 

I think that one way to keep our position, and possibly get ahead, is by 
putting out a very low cost machine. That's wl.y 1 felt honored when given 
the charter to start the design effort on Macintosh. 
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(* 

THE MACINTOSH PROJECT 
DOCUMENT 10 VERSION 2 

TITLE: VARIABLE MODEL OF MEMORY VS. DISK COSTS 
AUTHORS: JEF RASKIN AND PEGGY MILLER 
DATE: 3-A Oct 79 
*) 

PROGRAM TRADEOFF; 



TYPE SETOFCHAR=SET OF CHAR; 

CRTCOMHAND= (ERASEOS , ERASEOL , UP , DOWN .RIGHT , LEFT , LEAD IN ) ; 



VAR M X, L, D. s, TIME, COST, f.b.T.G.U.V.W: REAL; 

ITIME,1C0ST,IM: INTEGER; (*THESE NEEDED FOR PRINTING*) 

ITC: INTEGER [7] ; . i. j ^ 

(* The variable names have been chosen to correspond to Macintosh document 
number 7 which forms the documentation for this program*) 

CH: CHAR; 

CRTINFO: PACKED ARRAY [CRTCOMMAND] OF CHAR; 
PREFIXED: ARRAY [CRTCOMMAND] OF BOOLEAN; 
PRINT, DONE: BOOLEAN; 
REPORT : INTERACTIVE; 

PROCEDURE GETCRTINFO; 

(******************************************************** 

!* READ SYSTEM. MISCINFO AND GET CRT CONTROL CHARACTER INFO *) 

*) 

s********************^*******************************************> 

VAR BUFFER: PACKED ARRAY [0. . 5 1 1 ] OF CHAR; 

I, BYTE: INTEGER; 

F: FILE; 
BEGIN 

R£SET(F. '*SYSTEM. MISCINFO' ) ; 
1:-BL0CKREAD(F. BUFFER, 1); 

CLOSE(F) ; . , 

BYTE:-ORD(BUFFER|72)); (* PREFIX INFORMATION BYTE *) 

CRTINFO [LEADIN]:=BUFKER [62] ; PREFIXED [LEADIN] : =FALSE; 

CRTINFO [ERASEOS]: -BUFFER [6 A] ; PREFIXED [ERASEOS ]: =ODD (BYTE DIV 8 ; 

CRTINFO(ERASEOL):^BUFFER[65] ; PREFIXED [EKASEOL] :^ODD (BYTE DI V A ) ; 

CRT1NF0[R1GHT]:-BUFFER[66] ; PREFIXED [RIGHT] : =ODD(BYTE DIV 2). 
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CRT1NF0[UP] :-BUFFER167] ; 
CRTINFO [LEFT] : -BUFFER 168] ; 
CRTINFO[DOWN] :-CHR(10) ; 

END; 



PREFIXED [Ur] : =ODD{B\TE) ; 
PREFIXED [LEFT] :=ODD (BYTE DIV 32); 
PREFIXED [DOWN] :=FALSE; 



\** CRT COMMANDS ARE: ERASEOS ERAS EOL, UP, DOWN, RIGHT. LEFT. * 

^''^f'' PREFIXED [C] THEN UNITWRITE ( 1 ,CRTINFO [LEADIN] . i , 0. 1 2) ; 

UNITWRITEd, CRTINFO [C] . 1,0, 12); 
END; 



PROCEDURE PROMFTAT(X.Y: INTEGER; S: STRING) 

BEGIN 

GOTOXY(X,Y); 
WRITE(S) : 
CRT(ERASEOL) ; 

END; 



\l GET A CHARACTER. BEEP IF NOT IN OKSET, ECHO ONLY IF PRINTING *) 

VAR CH: CHAR; 

GOOD: BOOLEAN; 
BEGIN 

REPEAT 

R EAD( KEY BOARD, CH) ; 

IF EOLN (KEYBOARD) THEN CH:=CHR(13); 

GOOD:= CH IN OKSET; 

IF NOT GOOD THEN WRlTt(CHR( 7) ) 

ELSE IF CH IN [' '..')'] THEN WRITE(CH); 
UNTIL GOOD; 
GETCHAR:=CH; 

END; 



FUNCTION YES: BOOLEAN; 

BEGIN , . , .. 

YES:- GETCHAR(['Y','y'.'N','n']) IN [ Y , y J ; 

END; 
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PROCEDURE INIT; 
BEGIN 

GETCRTINFO; 

GOTOXY(0,0); CRT (ERAS EOS ) ; 

PROMFrAT(10,20,'DO YOU WANT THE RESULTS PRINTED? 
PRINT:- YES; 



); 



F 
B 

T 
G 
U 
V 

w 

D 
M 
X 
END; 



- 55.0; (*FLOPPY DRIVE COST*) 

« 1.6; (*MEMORY COST IN DOLLARS PER KILOBYTE*) 
-0.1; (*DISK TRANSFER TIME PER KB*) 

- 0.006; (*MEMORY SEARCH TIME PER KB*) 

- 1.0; (*MOTOR START-UP LATENCY*) 

= 0.15; (*MOTOR ON LATENCY (ROTATIONAL + AVERAGE SEEK)*) 

- 0.75; (*MOTOR SHUT-DOWN LATENCY*) 

- 18.0 ; (*DOCUMENT SIZE IN KB*) 

- 16.0; (*1NITIAL MEMORY SIZE IN KB*) 

- 6A.0; (*MAX1MUM MEMORY SIZE IN KB*) 
(*INIT*) 



PROCEDURE TIMECOST; 
BEGIN 

IF D <= M 
THEN 
BEGIN 

TIME (D*G); 
COST (M*b) 
END 
ELSE 
BEGIN 

s TRUNC (D/M) + 1; (*for convenience, s = S + 1 in document 7*) 
IF (D*G/s) > W 
THEN L U 

ELSE L :- V + W - D*G/s; 
TIME :- D*(G + T) + L*s ; 
COST :- M*b + £ 
ENL ; 

END; (*timecost*) 

PROCEDURE MENU; (* DISPLAY OPTIONS FOR CHANGES*) 

VAR VALUE: REAL; 
BEGIN 
REPEAT 

PRC»1PTAT(10, 20, 'Enter letter or press RETURN to continue '); 

CH :- GETCHAR(['F','B','T','G'.'U','V','W','D','X'.'Q',CHR(13)]); 
IF CH IN I'F','B','T','G','U','V','W','D','X'] THEN 
BEGIN 

PROMPTAT (10, 22, 'Enter new value '); 
READ ( input, VALUE ) ; 
CASE CH OF 

'F': F:- VALUE; 

'B': B:- VALUE; 

'T': T:- VALUE; 
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'C : 


G 




VALUE 


'U': 


U 




VALUE 


'V: 


V 




VALUE 


'W: 


w 


wz 


VALUE 


'D': 


D 




VALUE 


'X': 


X 


K 


VALUE 



END; 
END; 

GOTOXY(10,20); CRT(ERASEOS ) ; (*CLEAR PROMPT LINES*) 
UNTIL ( CH= CHR(13)) OR { CH - 'Q' ); 
IF CH •= 'Q' THEN DONL:= TRUE; 
END; 



PROCEDURE HEADER (FILEID: STRING) (* PRINT PAGE HEADINGS FOR REPORT*); 



VAR 1: INTEGER; 



BEGIN 

CLOSE (REPORT); 
RESET (REPORT, FILEID) ; 
WRITELN (REP0RT,CHR(12)) ; 
FOR I:- 1 TO 5 DO 
WRITELN (REPORT); 
WRITELN (REPORT, ' 

'VARIABLE MODEL OF MEMORY VS. DISK COSTS'); 
FOR I:- 1 TO 3 DO 
WRITELN (REPORT) ; 



END; 

PROCEDURE DISPLAY (FILEID: STRING) ; (*DISPLAY RESULTS*) 
BEGIN 

CLOSE (REPORT); 

RESET (REPORT, FILEID) ; 

WRITELN (REPORT, 'F ',f:10:4,' FLOPPY DRIVE COST typical value: 55.0'); 
WRITELN (REPO RT, 'B ',b:10:^, 

' MEMORY COST IN DOLLARS PER KILOBYTE typical value: 1.6 '); 

WRITELN (REPORT, 'T ',1:10:^, 

' DISK TRANSFER TIME PER KB typical valuo: 0.1'); 
WRITELN (REPORT, 'G ',G:10:A, 

' MEMORY SEARCH TIME PER KB typical valut-: 0.006'); 
WR1TELN(REP0RT, 'U ',U:10:A,' MOTOR START-UP LATENCY typical value : 1.0'); 
URITELN(REPORT, 'V ',V:10:A, 

' ROTATIONAL + AVERAGE SEEK LATENCY typical value: 0.15'); 
WRITELN (REPORT, 'W ',W:10:4,' MOTOR SHUT-DOWN LATENCY typical value: 0.75'); 
WRITELN (REPORT, 'D 'iD:10:A,' DOCUMENT SIZE IN KB: 6.0'); 
WRITELN (REPORT, 'X ',X:10:A, 

' MAXIMUM MEMORY SIZE IN KB typical value: 64.0'); 



WRITELN (REPORT, 'Q 
WRITELN (REPORT) ; 
WRITELN (REPORT, ' 



QUIT PROGRAM' ) ; 
MEMORY TIME COST 



TIME/COST') ; 
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WRITELN (REPORT, 
END; 



SIZE 



(HUNDREDTHS) DOLLARS 



* 10000'); 



PR(X:EDURt CALC(FILEID: STRING); (*CALCULATE RESULTS*) 
BEGIN 

CLOSE (REPORT); 

RESET(REP0RT,F1LE1D) ; 

M :- 16.0; (*RESET INITLAL MEMORY SIZE*) 
WHILE M <= X DO 
BEGIN 

TIMECOST; 

ITIME :«= TRUNC ( (TIME) *100. 0) ; 
ICOST := TRUNC (COST); 
IM := TRUNC (M) ; 
IF COSTo 

THEN ITC :« TRUNC ( (TIME/COST) *1000G. 0) 

ELSE ITC :>= 0; 
WRITELN (REPORT,' ' , IM : 6, ITIME : U, IC0ST:9, ITC:13); 

M M + 16.0; 
END; (*WH1LE*) 
END; (*CALC*) 



BEGIN (*MAIN PROGRAM*) 
INIT; 

DONE: -FALSE; 
REPEAT 

GOTOXY(0,0); CRT(ERASEOS) ; (*CLEAR SCREEN*) 
DISPLAY ('CONSOLE: '); 
IF PRINT THEN 
BEGIN 

HEADER ('PRINTER: ' ) ; 
D1SPLAY('PR1NTER: '); 
END; 

CALC( 'CONSOLE: ' ) ; 
IF PRINT THEN CALC ('PRINTER:'); 
MENU; 
UNTIL DONE; 
END. 
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THE MACINTOSH PROJECT 
DOCUMENT 11 VERSION 
TITLE: SUMMARY OF OCTOBER 10 
AUTHOR: JEF RASKIN 
DATE: 10 Oct 79 

1.0 APPLICATIONS 

1.1 TEXT EDITING 

Some form of text editing should be part of the firmware, and will form a 
major marketing feature. This editing ability should also be at the heart of 
the operating system, and will be available at all times. A proposal for the 
design of the text editor will be part of the specification. 

1.2 COMMUNICATIONS 

It is agreed by nearly all authorities that the personal computer will not 
achieve a mass market until communications networks are available to them. To 
help make this project a success, Apple will have to provide software that 
will ease access to various services, and perhaps adopt some stronger 
strategies, for example: 

1.2.1 INCLUDE CONTPvACTS WITH SERVICE VENDORS 

The purchase price of Macintosh might include a limited time contract with 
some vendor of personal computer network and data base services. Vendors 
might wish to do this as a "come-on". 

1.2.2 ESTABLISH APPLE NODES 

There is the possibility of building "nodes" 
a uniform interface to a number of services, 
is a value added network. 

1.2.3 BUILD AN APPLE NETVORK 

This would be a communications 
for personal computers as well 
services . 

1.3 CALCULATOR 

A simple calculator language should be provided. This will be explor 
separate document. 

2.0 MANUALS 



(See document M 3) that provide 
and which handle billinf. This 



network, not a data base. It would have access 
as ports to other networks and data base 
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Since this computer is going to a larger and n,ore diverse audience than over 
before the quality of the manuals will have to be especially high All 
appUcItrons'prosrams should have sc If -teaching sections, and any languages 
should also have computer based tutorials. 

The manuals should be well constructed physically, typeset, and ^^Jher wlr.-O 
or h^d bound. They should make use of color and graphics to a much greater 
extent than our present manuals. 

3.0 SOFTWARE 

Macintosh software will have to be written to the highest levels of quality of 

Tul n interaction. Updating programs in the "-^f-^^^^^ :,rc?''^' 

units we anticipate selling, will be nearly impossible. A zero-defect 
atmosphere will have to be maintained in software development. 

3.1 LANGUAGES 

3. 1. 1 PASCAL 

This is our standard language . and it should be provided, on disk, for 

Ma intosh. Since system development is not one of ^^J^f J^^J^^act hit 

for Macintosh, Pascal should be a purchasable item. ^^/P^^^ f 

Macintosh is not primarily a programming tool, ^^/^""J^^^fP^rr islind" 

generate the system software on the machine itself. This 

phUosophy assures that we will not build any essential weakness into the 

software. ^^^^ ■> 

3.1.2 BASIC 

It is not yet possible to offer a personal computer without BASIC. We will 
i e ^atever bLiC is implemented in Pascal for Lisa of^^^f/^^^ 
perhaps with the elimination of heavily business-oriented features. 

3. 1.3 APPLE 

The name "Apple" Is proposed for a programmable calculator style language that 
wniTthf subject of a future report. This language, along with the editor, 
may be part of the firmware. 



S.2 

4.0 



HARDWARE 



it. 1 INPUT AND OUTPUT 

There will be a keyboard (upper/lower case, similar to s'ara's and Lisa's but 
iJth eSeddcd numeric pad), one RS-232 port, one telephone port with moden, 
InSdaa (auto answer is Important, dialing would be nice) a video output, a 
"dulated video output, and some kind of extension bus. There will be no 
expansion slots per se. A few lines of LCD alphameric display should be an 
option. It would be advantageous to allow joystick input. 

A. 2 CPU AND MEMMORY 

The CPU choice (at present) is a 6809. There seems to be little advantage to 
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ED 



going to our own processor at this time. Memory is fixed at 6^,1;, consisting, 
of eight 64K dynamic RAMS. 

4.3 CAGE 

Since the requisite circuitry can fit onto a A8 sq in board, it is possible to 
have the computer not much larger than a keyboard alone. Figure 7 shows one- 
possible case, and figure 6 shows how it might be arranged internally. 

4. A POWER SUPPLY 

The power supply will be external via a wall-mounted transformer thus allowing 
the option of a battery supply. 

A. 5 DISPLAY 

If a configuration such as figure 7 is used, a LCD panel should be mountable 
in the lid. A separate iDonitor, In a matching and perhaps attachable case 
should be provided, as in figure 5. 

4.6 DISKS 

It is important to open a project to produce a low-cost, even if relatively 
low performance diskette drive. One way it could be integrated into the 
system is shown in figure 5. It is essential that some form of mass storage 
be made available to this system. 

A. 7 PRINTER 

Again see figure 5. It is essential that a printer be made available to this 
system. 
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THE MACINTOSH PROJECT 
DOCUMENT 12 VERSION 1 

TITLE: CONCERNS ABOUT USING THE TELPHONE WITH PERSONAL COMPUTERS 
AUTHOR: JEF RASKIN 
DATE: 9 Oct 79 

The ordinary telephone lines are the only bi-directional electronic 
communication links between most people. This is not only true for the United 
States of America, but for a significant portion of the rest of the world as 
well. The telephone lines are therefore the most obvious and accessible means 
for implementing inter-computer communications, at low cost. 

The technical problems have been solved, and electronic interfaces between 
computers, terminals, data acqusition and display devices and the phone line 
are inexpensive, often costing as little as a few months telephone service. 
Nothing special Is required of the telephone service in order to use these 
devices: the telephone system docs not distinguish voice from digital signals 
encoded as sequences of tones (or combinations of tones). In fact, it uses 
certain tones Itself to establish connections, and even to do some 
bookkeeping . 

The bandwidth of the telephone service imposes some limit on the speed of 
transmission. Inexpensive interfaces operate at a maximum of 30 characters 
received or transmitted per second. More expensive interfaces could run at, 
say, four times this rate over the same lines. Such faster interfaces for 
personal use are still a few years away. 

The main technical difficulties in using the phone network for personal 
computer communications is in adopting protocols that will allow computers 
to speak to one another. This problem is being addressed by a number of 
groups such as the PCNET, to name one among many. Assuming that this problem 
can be solved to a point where such communication becomes commonplace, or ^f 
the current timo sharing and data base services proliferate to' the point where 
individuals begin to use them as individuals (Instead of using them 
exclusively in connection with their employment or studies), we find another 
potential problem. The telephone system might start to move to disallow such 
use. 

At first it is not clear why the telephone system might oppose personal 
computer communications. It would seem that it would only mean increased use, 
and thus Increased revenue. Dr. Gammill. of the Rand Corporation (in his 
Position Paper on Personal Computers in the 1980's) and others have suggested 
that the telephone company might seek to limit or control computer useage In 
order to maximize Income by charging a higher rate for computer transmissions. 

Dr. Gammill points out that "from the point of view of the phone companies, 
personal voice communication Is under-charged due to regulation of that 
market", and since the tarriffs only apply to voice communication, new 
tarrifis, at (presumably) higher rates would be applied to digital 
communication. This would require that the phone company have special 
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equipment that can distinguish between the two grades of service. 

1 would like to suggest that there is a technological reason that the 
telephone companies might be concerned with digital use of a system intended 
for human communication. The phone system is based on a statistical model of 
phone use. There are not enough lines and interconnections so that all 
possible non-conflicting calls can be made at once. The amount of -equipment 
actually installed is based on assuming a certain percentage of the possible 
calls are being made at any time, and that calls have a certain distribution 
of lengths. Some calls last just a few seconds: "Hi, Jean?" "Hello Mary-" 
"I'll be over in five minutes." "See you then, bye." "Bye." Others last 
longer. 

The amount of equipment and personnel the telephone company needs depends on 
the maximum acceptable number of calls that cannot be completed due to lack of 
equipment, the total number of calls, and some statistics on the length of 
those calls. The problem with allowing digital transmission probably has 
little to do with the Increased number of calls due to such use. In the next 
few years the number of personal computers in use will remain under ten 
million, with, only a percentage of these being equipped for phone 
transmission. But there are over 100 million phones in dally use. So the 
number of calls made for the sake of a computer connection will remain 
insignificant for the time being. The same cannot be said for the length of 
those calls. 

As a very simple example, assume that there are 30 calls per hour' (at random 
times) on a system that can handle one call at a time. Also assume that the 
system requires no time at all to reject a call when the line is busy. If 
each call lasts one minute, then the probability that a given call was placed 
without waiting is about one half (it depends on some other factors such as 
the delay between retries). As these calls double in length, the probability 
that a given call was placed without waiting gets extremely small. If the 
calls are longer than two minutes in this example, they won't all fit — some 
calls can never be made. Notice that the number of calls has stayed the same. 

I suspect that this phenomenon is one of the things the telephone companies 
are concerned about. It is not the number of calls, but the large increase in 
average length that may well cause problems. 

What must not happen is that the users of personal computers get into a cat 
and mouse game with the phone companies. A possible senarlo Is this: a phone 
company sets up a special, higher rate for computer use. They add a circuit 
that detects the usual modem (the modem is the device that attaches a computer 
or terminal to a telephone line) frequencies and charges accordingly. At the 
same time they apply to the FCC to make those frequencies mandatory 
(ostensibly to help promulgate standardization and the free interchange of 
data). The computer manufacturers make a modem that "sounds" to the phone 
company more like the voice, so their detectors don't work. The phone company 
builds a better detector, and begins to throw in random .15 second pauses that 
Interfere little with speech but play hob with digital transmission. The 
computer buffs respond with error-correcting codes that correct for small 
pauses, and make still more voice-like modulation. The phone company could 
respond with a rate scheme that vastly increases the cost per minute after 10 
minutes This could be an expensive and counter-productive war. 
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If we h.v. th. v.rlou, utltllty co.«lsslon. .^6 the Federal Co.-un Icat Ions 
..Ls*:: Involved « be ,e.r= P'-^-'i,':^,;;:; ^T"" 

,.ts »der v„. There .re ' '.riov hr e .phone eo.pan, 

;rd!L"r.i?nStrh^itinr;s: ronrrn."or.";iiepSo„ <» .he 

;i:rpel:i: o:n"cii."i"te':if ^LlnaU over the phone and that Che, .hould 
not have to suffer a higher rate. 

rather naturally, interested In this situation, and would like to hear 
interested parties. 
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THE MACINTOSH PROJECT 
DOCUMENT 13 VERSION 1 

TITLE: IMPORTANT POINTS ABOUT MACINTOSH 
AUTHOR: JEF RASKIN 



DATE: 12 Oct 79 

1. The design assumes the existence of a network allowing nationwide 
communications. Macintosh is a communications device. 

2. The cost of the main unit shall be $500, with hopes of 
lowering that cost to §300 in three years. 

3. The design shall have peripherals that attach mechanically as 
well as electrically, making a unified package. 

A. Some functions will be available In ROM, in particular, the network 
protocols, some word processing, and possibly a simple programniahle 
calculator style language. 

5. It will contain a modtm/daa, an RS-232 port, a real-time clock, speaker 
and video and modulated outputs. 

6. Disks, printers, a TV monitor, speech recognition and synthesis devices, 
and battery power supply are examples of possible peripherals, and will 
not be part of the main unit. 

7. RAM size will be fixed, and probably 64K bytes. The processor will 
be a commercially available product, possibly a 6809. 
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THE MACINTOSH PROJECT 



DOCUMENT UA VERSION 10 



TITLE: THE APPLE CALCULATOR LANGUAGE PK^TTTR 



AUTHOR: JET RASKIN 



DATE: 13 Oct 79 



{Note: material in braces is notes to myself, or notes to the advanced reader. 
The reader might well comment that the following language seems similar to the 
work done by K. Iverson over eighteen years ago. Apple is based on a re- 
spelling of Iverson's work. Even the name "Apple" might seem derivative from 
the name he chose for his language.} f^rPcfS A^L 



CHAPTER 1 



IT'S A SIMPLE CALCULATOR 

To begin with, this language only uses the numbers, the signs for simple 
arithmetic, and the large key over on the right side of the keyboard marked 
with the word "RETURN". Press this key whenever you see the word "RETURN" in 
a box. Later we will use the other keys too, so as not to be wasteful. 

You can tell that it is your turn to type whenever you see an exclamation 
point (1) sitting at the left edge of the screen. As soon as you begin 
typing, the first character that you type replaces the "!". The exclamation 
point is callf'd the "prompt" character, because it prompts you to type 
something. 

Now you know when you can type something. Type 
5+2 [RETURN] 

The computer responds by showing the result 
7 

We must say a word about fixing typing errors. You can correct a typing error 
by backspacing over it and typing the correct information. To backspace, 
hold down either button marked "SHIFT" and press the space bar. 

Subtraction is indicated by the usual minus sign 

5-2 [RETURN] 

3 

{Negative numbers are indicated by preceding tliem with an underscore (_) , e.g. 
In this manual, any line not followed by [RETURN] is produced by the computer. 
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In this case, the answer 3. 

Multiplication Is indicated not with an "X" but with an asterisk (*). 

3* A (RETURN] 

12 

Division is indicated by a slash {/) 

A/2 (RETURN] 

2 

7 /A [RETURN] 
1.75 

You can do more than one arithmetic operations in the same lint-, 
for example 

6/3+2*5 [RETURN] 

20 

A combination of a number of operations such as this is called an 
"expression". The rule for evaluating an expression is very simple: Start at 
the left and move to the right. The expression 6/3+2*5 starts out as 6, the 
leftmost number. It is then divided by 3. That's 2. Then you have to add 2: 
that makes A. Now multiply the result by 5: the result is 20. 

If you are- familiar with simple pocket calculators, you will recognize that 
this is exactly how they work. You put in a number, then an operation, then a 
second number and press the button with an equal sign. In this language you 
press (RETURN] instead of the equal sign. Evaluating an expression is exactly 
like doing a "chain calculation" on a pocket calculator where you don't bother 
to get intermediate results. 

If you are familiar with other computer languages, or do a lot of algebra, you 
might find this strict left-to-right scanning a bit unfamiliar. Actually, if 
you think about it, this -method is more consistent and simpler. This is one 
of those cases where the -beginner with no prior computer experience has the 
advantage . 

If you wanted to add 6/3 to 2*5, you could write the expression 

(6/3)+(2*5) (RETURN] 

12 

Parentheses are used to group items that are to be evaluated together and 
subsequently used as a single entity. 

What would be the value of 



M lAA. 10 Page 2 

■■RaskinDoc003 1 048.PICT' 1 45 KB 2000-02-27 dpi: 300h x 300v pix: 2051 h x 3063v 



Source: David T. Craig 



Page 0050 of 0174 



Jef Raskin Document # 003 -- Macintosh Project Memos (February 1980) 



The * Macintosh Project: Selected Papers (14 Feb 1980) of 171 



55/11+1+12/6*2-3 

as interpreted by the computer? The answer isn't 13. The answer isn't 7. In 
fact there are a whole lot of numbers that the answer isn't. 

{ The answer is 3} 

Powers of numbers, such as 2 to the tenth, are easily obtained. 

2 TOTHE 10 [RETURN] 

102A 

And to get a square root, you could write 

2 TOTHE .5 [RETURN] 

1..41 

Notice that the answer comes out to two decimal places. This is the 
standard, or default number of decimal places. You can get almost any number 
of decimal places you want. Up to a limit of {say, 18}. For example, to get 
seven places, you would type 

-7: PIACES [RETURN] ^» '\ 



2 TOTHL .5 [RETURN] 
1. AU2136 

The answer is rounded to seven places. This only affects what the computer 
shows: inside it. knows the truth and remembers as many decimal places as it 
can. It will continue to show answers to seven places until you give it some- 
other number of places. Here is another example: 

10: PLACES [RETURN] 



22/7 [RETURN] 
3. 1A2857U28 



1: PLACES [RETURN] 

22/7 + .6 [RETURN] 
3.7 

0: PLACES [RETURN] 

22/7 + .6 [RETURN] 



A 
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{There might be a WIDTH specification as well, 
specification this controls precision.} 



Together with the PLACES 
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CHAPTER 2 

CLUMPS OF NUMBERS 

Here is an easy one to figure out 

17 tRETURN] 

17 

The simplest expression is just a number. It is not much more complicated to 
have a clump of numbi-rs, separated by spaces. 

34 5 67 [RETURN] 

3i* 5 67 

A clump of numbers acts pretty much like a number in an expression. When you 
add a number to a clump, you add it to each number in the clump. For example 

34 5 67 + 3 [RETURN] 

37 8 70 

The way to figure out how to handle a clump is to start from the left (as 
always). First you find the 3A, then a space, then the 5. Since there was no 
operation between them, you know that they must be part of a clump. Then you 
find anotlier space, followed by the 67. Since you have encountered no 
operation, the 67 is also part of the clump. The next thing you find is a 
space followed by a plus sign, indicating an operation. This is not a 
number, so the clump is finished. The operation symbol you just found tells 
you what to do to the entire clump, in this case you add three to each member 
of the clump. 

Here is an example with multiplication. 

1 2 3 A 5 *6 [RETURK] 
6 12 18 24 30 

Just ore more example of usinp a clump. 

2 5 1-2 IRETURN] 
3 _1 

Remember how negative numbers are indicated. There is a very good reason for 
distinguishing the operation of subtraction from negative numbers. For one 
thing. It is never good to use one symbol to represent two different 
concepts. Furthermore-, if we didn't distinguish these ideas, how would 
you put a negative number into a clump? 

Now let's evaluate 
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7 + 2.51*6 

Starting at the left you find a 7. The next thing you find is a plus sign, so 
a clump isn't being formed. Continue to the right and you find a 2. Now you 
can perform the addition and add 7 to 2 to make 9. The expression -is now 
equivalent to 

.9.51*6 

Clearly 9, .5 and 1 form a clump, and then you find a multiplication sign, so 
the clump is done. Now multiply each element in the clump to get the answer 



5A 3 6 

Parentheses are quite useful. For example you can use parentheses to write 



7 + (2 .5 1) * 6 

The seven is added to the entire clump, to give 



9 7.5 8 * 6 



which evaluates to 



5A A5 A8 

All this makes the calculator much more convenient for calculations involving 
a whole bunch of numbers. For example, to convert 32, 50, 100 and 212 degrees 
Fahrenheit to degrees Celsius, you could write 

1: PLACES (RETURN] 



32 50 100 212 -32*5/9 (RETURN] 
10 32.8 100 

(We didn't have to limit it to one decimal place, but we did, for appearances 
sake.) To see how this works inside the computer (and how you can figure 
out the answer yourself), the first part of this expression is equivalent to 
(32 50 100 212)-32, or 18 68 180. This new clump is then multiplied by five, 
yeildlng 90 340 900. Lastly, it is divided by 9 (remember, just work fron 
left to right) to yelld 10 32.8 100. 
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CHAPTER _3 
AUTOMATIC CLUMPS 

Some of the most useful clumps of numbers are just consecutive Integers, for 
example the thirteens multiplication table can be obtained by 

123456789 *13 [RETURN] 

13 26 39 52 65 76 91 lOA 117 

You can abbreviate a clump of consecutive integers by use of what is called, in 
English, the ellipsis. The ellipsis is a kind of punctuation in a class with 
such things as periods, commas, semicolons... 

Those three dots are the ellipsis. To save you a bit of typing, the computer 
uses two dots. The thirteen's table can be produced by the expression 



1..9 *13 (RETURN] 



13 26 39 52 65 78 91 lOA 117 

Of course, you can count backward 

5.-2 +3 [RETURN] 



8 7 6 5 



{Interestingly , 

5.. 7.. 2 [RETURN] 

5A3265A32765432 



Why is this? Because 5.. 7 is 5 6 7, so the expression is equivalent to 



(5 6 7). .2 

which is 5.. 2 6.. 2 7. • 2 

Just remember to do thing^s strictly from left to right. Also notice that if 
real numbers are used whete integers are expected, as in 3. 6.. 7. 2, they are 
truncated to integers 3. .7} 

So far we have done arithmetic between a single number and a clump. When 
clumps are the same length, we can easily do arithmetic between whole clumps 
at a tine. It is done element by element. 



(12 3 4)+(4 3 2 1) [RETURN] 
5 5 5 5 

But remember, without parentheses, you have to work things through fr 
to right, element by element. 
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12 3 4+4321 [RETURN) 



5 6 7 6 3 2 1 

This can be checked by starting to form a clump 1 2 3 A. Then you find an 
operation, which applies to the whole clump. The operation is to add four to 
each element of the clump. That gives you 5 6 7 8. There is no operation 
before the next number, so you must still be clumping. This explains the 
given answer. 

{This also shows that juxtaposition indicates concatenation of output. 



Another example is 
2.-6 3.. 1 (RETURN] 
2 3 A 5 6 3 2 1 



You might like to try 

1..4+4--1, which is equivalent to 

(12 3 .1, but this is 



(5 6 7 8)..l or 



5432165A32176543216765A321 



Now consider 



(1.. 2)+(l. .3) [RETURN] 



2 A 3 

These two clumps are of different lengths. The shorter clump is always "padded" 
to make it equal in length tn the longer. In this case it is padded with 
zeros. {The identity element is always used as padding. For addition and 
subtraction it is 0, for multiplication and division it is 1. A more complete 
list of padding elements is presented later.} 



One last thing to try 
3/0 [RETURN] 

YOU MUSTN'T DIVIDE BY ZERO 

This is an example of a "error message" which tells you that you have done 
something beyond the pale. 
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CHAPTER ± 

SOME OTHER OPERATIONS 

It is sometimes convenient to be able to get just the remainder of a division. 
In accord witli common practice, this is indicated by MOD 

3 MOD 2 IRETURN) 

1 

If you divide 3 by 2 you do, indeed, get one left over. This next example is 
educat ional 

1. . 16 MOD 7 [RETURN] 

1234560123A56012 

You can get the greater or lesser of a pair of numbers. 

3 MAX 38 [RETURN] 

38 

3 MIN 38 (RETURN] 
3 

38 MAX 3.09 [RETURN] 
38 

17.. 21 MAX 19 [RETURN] 
19 19 19 20 21 

With clamps of equal length you can easily do this 
1 2 A 8 16 MIN (13 6 9 12) 
1 2 A 8 12 

And. similarly, you can compare numbers. In this language the number is 
used to indicate that an answer is false, and 1 indicates that an answer is 
true. While this may seem a bit strange, we will be able to use these values 
in some rather neat ways later. 

The sign ">" means greater than. 

16'i2 > 31.008 [RETURN] 

1 

5 > 7 [RETURN] 
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The equal sign (•=) we use unblushinply to mean equals. 

3 - A [RETURN] 



6.4 - 6.4 IRETURN] 
1 

We use "<" for less than, but won't bother with any examples, but go on to use 
"<=" for less than or equal to and ">=" greater than or equal to. 

18 <«= 3 IRETURN] 



7 >= 7 IRETURN] 
1 

Lastly, in this group, we use "<>" for not equal to, since it has the moaning 
"greater than or less than" which is the same idea. 

5 <> 5 [RETURN] 



Observe that you can compare to a clump 
123A56>3 [RETURN] 
1 1 1 

For those who need them, we have the functions AKD, OR and XOR. 

AND [RETURN] 


1 OR [RETURN] 
1 

1 AND (RETURN] 


in all the familiar combinations. For example 
1 1 OR (0 1 1) (RETURN] 
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1 

Why didn't we write 1 1 OR 1 1 ? 

{Because that would be 1 1 and not show all the combinations.} 
Why didn't we have to write (0 1 1 ) OR (0 1 1 )? 

{Because we evaluate frora left to right, but it might not be a bad idea to 
sometinies use redundant parentheses in a situation like this to inakt the 
expression clearer.) 

1 XOR 1 [RETb-RN] 
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CHAPTER b 

SOME SCIENTIFIC CALCULATOR ABILITIES 

For those of you that like your calculators scientific, we have sines and 
cosines and the like. On the typical calculator, if you have a ^"nber in the 
display, and want to find its sine, you press the button marked "SIN" (no 
religious Implications intended). Similarly, in our lef t-to-right scheme, 
after you have a number you just type "SIN" and the result is calculated. For 
example 

3.U1592654 SIN [RETURN] 


Here, we are working in radians. If you'd rather work in degrees, you 
have an option, the way you did with the number of decimal places. You can 
set the option "RADIANS" to true or false. If it is true, you are working; in 
radians; if it is false, you are working in degrees. 

From the sine value above you can conclude that you were working in 
radians. If you want to work in degrees, you make RADIANS false. It works 
very much like PLACES did. 

0: RADIANS [RETURN] f ' w ' >'■' I ' i / ' .T 

30 

To get back to working with radians, you would type 
1: RADIANS [RETURN] 

Incidentally, if, at any time you want to find out to how many decimal places 
the computer will display, you can just type 

PLACES [RETURN] 

4 

Or, to find out if you are working in radians or degrees, you can type 

RADIANS (RETURN] 



The trigonometric functions you have available are 
SIN COS TAN ARCSIN ARCCOS ARCTAN 

Also you have LOG (which is base 10) and LN (which is base e). 
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There is even a constant 
PI 

with the usual value. You can say 

PLACES: 3 [RETURN] 

1..4 * PI (RETURN] 

3. 1A2 6.283 9-425 12.566 

Incidentally, what would you get from PI * 1..4? 
{3 A} 

{The base of the natural logarithms is available. Its name is "E".} 

We also have two simple functions, FLOOR and CEILING. FLOOR gives you the 
greatest integer less than or equal to the given number; CEILING gives you the 
least integer greater than or equal to a given number. 

5.1 17 -5.1 FLOOR [RETURN] 

5 15 -6 

5.1 17 -5.1 CEILING [RETURN] 

6 17 -5 

In the same vein we have 

22 22.1 22.5 22.51 22.8 ROUND (RETURN] 

22 22 22 23 23 

and we can truncate 

22 22.335 22.8 -5. A3 -4.9 TRUNCATE (RETURN] 
22 22 22 -5 -4 

And here is a strange, but enjoyable function- You'll have to puzzle it out 
from these examples- 

3 PICK (RETURN] 

3 

4.. 8 PICK [RETURN] 
5 

4-. 8 PICK [RETURN] 
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4.. 8 PICK (RETURN] 
A 

A.. 8 PICK [RETURN] 
7 

It gives a random choice amonp, the clump presented to it. 
There is also one logical operator among these functions 

NOT (RETURN] 
1 

1 NOT (RETURN] 


If you apply NOT to numbers other than and 1, the results may seem strange-, 
so it is not recommended. {The logical operators applied to integers result 
in bit-wise operations. If the numbers are not integers, they are first 
truncated • } 

Here are some puzzles. Fill in the computer's part. 
NOT 3 [RETURN] 
{1 3} 

1 NOT (RETURN] 
{1 0} 

3.1 »5.6 -b.2 3.8 +.5 CEILING [RETURN] 

{This evaluates as follows 3.6 ^5.1 -A. 7 4.3 CEILING which is A -5 -i 5} _ 
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CHAPTER b 

SAVING FOR A RAINY DAY AND WITH WORDS WE LEARN TO PLAY 

Many calculators have a way of scoring a number, then later recalling it. 
This is usually called "memory". In this Apple Calculator, there Is also 
memory. For example, to save the value 5 you merely give it a name. In this 
case we'll call it "fingers". 

5: fingers [RETURN] -• > '' 

Notice that the conputer types nothing back to you (except the prompt, which 
we never show in this manual. It now sits there awaitinp your comcand. And 
it remembers that the value of fingers is 5. 



You have seen that 



5 (RETURN] 



5 



Well, now that you have defined fingers you can type 



fingers [RETURN] 



5 



Of course 



13 56 72: hike [RETURN] 



hike [RETURN] 
13 84 56 72 
hike -20 [RETURN] 
-7 64 36 52 



So you see that you can store numbers and clumps of numbers into cubbyholes 
that have names. Names ^an be as long as you like; just remember that you 
will have to type them so you might not want to make them too long. The rest 
of the rules for names are simple: they must begin with one of the twenty six 
letters of the alphabet in upper or lower case, they may contain letters of 
the alphabet, digits, and periods. Blanks are forbidden. It is recommended 
that names be all lower case. For example 



f lavor-number . 58 

is a legal name. It is customary to write names in lower case characters 
that they are easily distinguished from keywords, such as SIN or TRUNCATE. 
You may not use any keywords (which are always upper case) as names. 
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This flexibility to use names that wo devise ourselves makes this calculator a 
little bit easier to use than most pocket calculators. It sure is easier to 
remember that you've put the checkbook balance into a cubbyhole named 
"balance" than to remember that it is in "register 4". 

Our calculator doesn't only deal with numbers, but with letters as well. As 
you know a cat has four legs, but the word "cat" has no legs at all. It has 
three letters. We distin£uish, in English (and most other phonetic tongut-s) 
between the way the word is written and its meaning by using quotes. This is 
true of the Apple language as well. Here are some examples. 

"cat" (RETURN?'* 

cat 

It should be clear that 

fingers [RETURN] 

5 

"fingers" [RETURN] 
fingers 

One very useful ability is to be able to find the number of characters in a 
string. 

"fingers" LENGTH [RETURN] 
7 

Incidentally, this function also works with clumps of numbers 

12 3 LENGTH [RETURN] 

3 

3.. 9 LENGTH [RETURN] 
7 

Is this answer correct? 

{Sure is, even though 9-3 is 6.} 

As we have seen. Just writing two clumps one after the other gives a longer 
clump 

2.. 6 7.. 5 [RETURN] 
23^56765 

the same thing happens with letters 
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"had"^"dock" " smells" [RETURN] 
haddock smells 

This is called "concatenation", the bringing together of two or more objects 
side by side. Notice that the space between the quote and the word "smells" 
is not accidental. 

Letters between quotes are called strings. You can concatenate strings even 
If they have been given names. 



"abcd":alpha [RETURN] 
"efghij":bet [RETURN] 
alpha bet [RETURN] 



abcdef ghij 

Every name, whether you use it or not, has a value, 
elephant [RETURN] 







That is because any name that you haven't given a value to is zero. If the 
name is used as part of an expression involving strings, and it hasn't been 
given a value, then its value is a string with no characters. This is called 
the "null string" in the jargon. In this example the name "alphabet" has not 
been given a value, so it is the null string and has no effect when 
concatenated to the string named "alpha". 



alphabet alpha [RETURN] 



abed 
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CHAPTER J_ 

AN INTERLUDE: A SUMMARY AND RE-PRESENTATION 



The prompt character is "I", and it Is overridden by the first typed 
character. User input is terminated by {RETURN]. 

The dyadic operators (those that come between two quantities and do somothing 
Involving both of them to result in another qantity) are 

+ - * / TOTHE .. MOD MIN MAX < «= > >= <= <> AND OR XOR INSERT 

0011 1 1 0000000 10 

The numbers under each operator is the padding value in case the operation is 
attempted between clumps of different lengths. Strings are padded with nulls. 

The special variables (names that have a meaning to the system) are 



PLACES. RADIAKS PI E 

The monadic operators (those that come after a quantity and do something 
involving it) are 

SIN COS TAN ARCSIN ARCCOS ARCTAN NOT LOG LN FLOOR CEILING ROUND TRUNCATE PICK 
LENGTH 

Names may begin with any letter, and may have letters, digits and 
underscores. The assignment operator, which should be a right-pointing arrow, 
is the colon because ASCII doesn't have a right-pointing arrow. Expressions 
are evaluated strictly from left to right, but the order may be modified with 
parentheses. Any printing characters, space, and return may occur in 
strings. Much more is to come.} 
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CHAPTER 8 

A FEW MORE STRING OPERATIONS 

Strlncs can be converted to clumps of numbers and vice versa. A table {the 
standard ASCII codes} shows what numbers go with what characters. For example 

"ABC" NUMBER [RETURN] 

65 66 67 

68 69 70 LETTER IRETURN] 
DEF 

If you give the LETTER function a number too high to represent any letter in 
the clump, then it gives back the null character. 

{It is nice if 

"" NUMBER [RETURN) 



and vice versa}. 

You can compare two letters 

"a" > "b" [RETURN] 



You can compare strings for alphabetic order 
"jello" <= "hello" (RETURN] 

1111 

"jello" > "heljo" (RETURN] 

1 C 

just as you could for clilraps of numbers. 

It is sometimes useful to deliberately change the value of a numerical 
quantity into a string, for example 

34 STRING "b" [RETURN] 

3Ab 

And to go the other way, there is the VALUE function 
"2" VALUE +1.1 (RETURN} 
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3. 1 

Single quotes are used when the string has double quotes in it 

'He said, "Do not shoot, 1 have a cold".' : line. frotn. movie [RETURN] 
line. from. movie [RETURN] 
He said, "Do not shoot, I have a cold". 
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said , 



Don 



t shool , 1 have a cold 



CHAPTER / 

INSERTING OPERATIONS INTO CLUMPS 



Let's say you wanted the odd numbers between 1 and 19 inclusive. It Is easy 
to get the even numbers between 2 and 20 



1..10 * 2 [RETURN] 

2 4 6 8 10 12 U 16 18 20 

if you then subtract 1, you get the odds (in this example they are first 
stored under the name "odds" and then displayed.) 



1. . 10 * 2 - 1: odds [RETURN] 

odds [RETURN] 

1 3 5 7 9 11 13 15 17 19 



Now, say you wanted to find the sum of all the odds in this range. You could 
write the expression 

1+3+5+7+9+11+13+15+17+19 

which does the trick. But there is an easier way. You can automatically 
insert any operator that works on two entities (called a "dyadic" operator) 
between all the elements of a clump. The operation is called "INSERT". After 
the word "INSERT" you place the operation you want inserted into the clump. 
For example, the sum of all the odd numbers above can be easily obtained by 

odds INSERT + [RETURN] 



100 

You can get the largest of a clump of numbers by using INSERT MAX 

3A.667 92 3 _A5.09 INSERT MAX (RETURN] 

92 



The smallest of a clump': 
odds INSERT MIN (RETURN] 
1 

To demonstrate another application of INSERT, we introduce the monadic 
function ODD. 



11 ODD [RETURN] 
1 
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said , 



Don 



t shoot, I havL- a cold 



34 ODD (RETURN] 


ODD determines if a number Is odd. Here is a clump 
12 34 55 18 67 31 24 : bunch [RETURN] 

For convenience, we have given the clump a name. It is simple to find how 
many odd numbers there are in the clump. 

bunch ODD INSERT + (RETURN] 

3 

This tells us that there are three odd numbers in the bunch. Step by step, it 
works like this: 

bunch ODD 

evaluates to 

10 110 

and then 

10 110 INSERT + 
evaluates to 

+ + 0+1+0+1 + 1+ 

which is 

3 

How many even numbers in the clump? 
bunch LEN - bunch ODD INSERT + 
Or, you can use the handy- EVEN operator 
bunch EVEN INSERT + 

We can ask, for example, how many examples of the letter "e" occur in a text. 

"The quality of mercy is not strained." = "e" INSERT + (RETURN] 

3 
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\ Don 



t shoot, I have a cold 



said , 
CHAPTER /^ 

SELECTING ELEMENTS FROM A CLUMP 

By this time, you are quite experienced, so a few examples should suffice, 
"abcde" [IJ [RETURN] 



"abcdc" (2) (RETURN] 
b 

"abcde" 15] [RETURN] 



"abcde" [2 5 1 ^1] [RETURN] 
bead 

12.5 99 63 [2] [RETURN] 
99 

12.5 99 63 (5] (RETURN) 

i. 



"abode" [_3] (RETURN] 

This last example evaluates to the null string. 



ABOUT CLUMPS 

i. ETYMOLOGY A!)D PHYLOGENY OF CLUMPS 

Clumps are a data structure. I searched about for a while to find this n 
The best English word for them is probably "lists". A shopping list is an 
excellent model: 

One Useless 

Three boxes of Dreadful 

Two pack-ages of a dozen Expensives each 
A pound and a half of Unobtainium 
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ABOUT CLUMPS 

1. ETYMOLOGY AND PHYLOGENY OF CLUMPS 

Clumps are a data structure. 1 searched about for a while to find this naim. . 
The best English word for them is probably "lists". A shopping list is an 
excellent model: 

One Useless 

Three boxes of Dreadful 

Two packages of a dozen Expcnsives each 

A pound and a half of Unobtalnlum 

A Gimcrack 

A dozen Shoddies, or a bag of Overpriced, whichever is cheaper 

However, the word "list" has been pre-empted by computer science to mean a 
clump with pointers between the items in the clump. A clump is something like 
a vector, but the word "vector" is scary to many beginners, besides, the 
terms "vector" and "array" in most technical parlance usually imply 
elements of like kind. The same problem applies to "matrix". A clump is not 
a set, since it's elements arc ordered: it is an ordt-red set, but that name 
is too clumsy. I can't use many other English words, such as "group" or 
"conglomeration" or "accretion" on the grounds of overuse, lack of euphony, or 
excess length. Thus, "clump". This word also has the feeling of "sticking 
together", which is how clumps behave in expressions. (The verb "to clump" 
means to put things together in generally irregular ways.) 

The word "clump" has a certain informality about it. This corresponds nicely 
to the way they are used. Clumps are not declared , they just happen as they 
are needed. Clumps are not fixed in size or composition. However, the> are 
ordered; each clump has, at any moment in a program's execution, a fixed 
number of elements, each associated with an ordinal number that gives its 
position. CInmp f T ara H "n r»^ 

A clump may have an element that is, itself, a clump. There is no null clump. 

If you create a clump, it Is assumed to be something, depending on context. 
The smallest clumps are things like the null string, a single numerical value 
(possibly zero), or just one other clump. Clumps are the only named objects 
In this language. Programs are clumps. 

1 fear a strong abreactlon from structured programming devotees. I wish to 
say to them: live and let live. Programming languages and structures are 
tools, and each tool has Its rightful place. Computers are not only to be 
used by carefully disciplined coders in phalanx. They are also to be used by 
undisciplined non-programmers who care to solve a problem in the quickest, 
most haphazard way they can. You cannot argue with human happiness, and a 
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formal, structured, declared approach is not always appropriate. If you thlrik 
that it is, then you have a bit of the martinet or despot in you, and wouJd 
have everybody toe the line and write magnificent, portable, durable code. 
If you are true to form, you probably won't let anybody write a quick note in 
pencil to a friend, but require them to have it typeset, on lOOt rag paper, 
and sent by liveried messenger. 

Apple is an informal communication between a user and his or her computer, it 
is quick, impc-rmanent, friendly, and useful. Do not fret, my structured 
friend, you will not be put out of business, nor threatened by this any more 
than 1. a professional writer by trade, am threatened by universal literacy. 
Such literacy just means a wider audience for my professional talents. So 
will it be for programmers. The more people know how to program and use 
computers (the two are not synonymous) the more customers there will be for 
good programs. The more a person knows about programming, the more he or she 
realizes the quality of a fine program. Apple is no impediment to the writing 
of fine software. 



2. THE ELEMENTS OF CLUMPS 



The elements of clumps are of two kinds 



A. Numbers 



A number is a sequence of digits and, optionally, a decimal point.. There Is 
no notation for powers of 10 such as 34.2EU. Such numbers can be represented 
externally using the usual notation for powers. The output routines will do 
this when necessary. There is no problem on input, since expressions can be 
used wherever a constant may be. The internal representation of numbers is 
not a really a concern of the language design, except that it is expected that 
there will be at least 18 decimal digits of precision. Numbers will generally 
be stored as integers unless a real representation is required. The precision 
of the representation may also change. 

B. Characters 

Characters are those codes that can be generated by the computer. Some of 
them (at least the usual set of 96 ASCII/ISO characters) can be shown on a 
display or printed. They are: 

ABCDEFGHIJKLMNOPQRSTUVWXYZ (26 uppercase letters) 
abcdef ghijklmnopqrstuvwxyz (26 lowercase letters) 



123A5678890 (10 digits) 

!"*$2^'()0*='~<+><>'_ (33 special characters) 



(1 space) 

Strings are no part of the language. There are Just clumps of characters. 
3. A FORMAL, BEEN EFF, DEFINITION OF CLUMPS 
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A formal item in braces means that it may appcfar zero or more times. 

digit I 1 I 2 I 3 I 4 I 5 I 6 I 7 I 8 I 9 

decimal point . 

Integer : ■= <digit>{<diglt>} 

number :- <integer> | <integer xdecimal point> | <decimal point><lnteper> 
I <lnteger><decimal point><integfcr> 

character 1 ;» <any of the 96 characters shown above except the single quote> 

character2 : ■= <any of the 96 characters shown above except the double quote> 

letter :« <any uppercase or lowercase letter> 

name := <letter>{<letter> | <digit> [ <decimal point>} 

space := 

string "<<character2}" | '{<characterl>>' 
element :« <string> | <number> | <name> 
clump :« <element><space><clump> 

Note that Integers and strings per se do not appear as separate concepts in 
the user's view of the language, and that exactly one space is specified 
between clumps. 

4. EXPRESSIONS INVOLVING CLUMPS 

We first define the assignment operator which has the form 
<clump> : <name> 

Thereaitcr the name stands for the clump. The value includes type and 
structure information. This is different than most languages where this 
information is associated with the name, rather than the value. 

Every clump has a length L. L >= 1. This length is the number of 
elements that comprise it. 

There are two kinds of operators in this language, monadic and dyadic. 
Operators may be distributing, expanding or reducing. A distributng operator 
operates on each element of a clump and leaves a different clump of the same 
length. A reducing operator reduces a clump to a smaller clump, usually an 
element. For example, the LEN operator reduces a clump to a number, the 
assignment operator (:) reduces a clump and a name to a name. The sequence 
operator (..) takes two numbers A and B and expands them into a clump of (E- 
A+1) elements. 
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A monadic operator occurs after the clump on which it operates. A dyadic 
operator occurs between two clumps. 

monadic operator := LEN | (to be filled in) 

dyadic operator + I - I * I / I TOTHE | MOD | : | . . | (to be filled 
In) 

expression :« <clump> | <clump><nionadic operator> | 
<clump><dyadic ope rator><expression> 
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POSTSCRIPT AND DIATRIBE 



To the Reader: 



To those of us not familiar with APL, this language may seen a bit odd. To 
those of us who know APL, this language may seem a bit odd too, but in a 
different way. One of the major aims of the designer of general purpose 
computer languages should have is to Improve the quality of life of the 
programmers who will use It. The important item here is the programmer or 
user, not the system. The whole idea of a higher level language is this: 
programming time is very dear, lot's use the computer to minimize it. As 
computers become cheaper, this strategy becomes ever more valuable. Computers 
are now very cheap. In the room in my house where I am writing these words 
(on a computer system) are no less than three computers. The most expensive 
piece of equipment, on an hourly basis. Is me. 

It Is with the utmost trepidation that I dare to attempt to design a new 
computer language. New computer languages are plentiful and easy to come by, 
many old language are adequate and well entrenched. My motivations are 
simple, and relatively pure. The advent of personal computers gives me 
sufficient excuse, and a new potential audience. None of the major languages 
was designed for use by untutored individuals using computers in their 
personal lives. And, as I shall attempt to show, none of them is truly 
suitable to this arena. 

My main motive Is to give people as much power for as little effort as I can 
conceive. 1 have been procramming computers for most of my life, and of the 
many languages I have used, one stood out as permitting me to accomplish. In a 
given amount of programming time, more than any of the others. Subsequent 
studies by others have shown that I was not unique In my appreciation of this 
language. But before going on, perhaps a brief examination of the broad 
characteristics of computer languages, from the point of view of programmer 
effort, and why each language Is popular Is In order. 

A VIEW OF EXISTING LANGUAGES 

One language Is "higher" than another if Its primitives are constructs in the 
other. Sometimes "higher" depends on the task. For many processes involving 
lists and grammars, LISP is a very high level language. It is not quite so 
high level a language for" some engineering applications. The major directions 
in higher level languages might well be summed up in these words: ALGOL, 
BASIC, COBOL, SNOBOL, LISP, APL. 

FORTRAN and PL/1 are derivatives or fellow travelers of ALGOL, as is Pascal. 
As declared languages they are inherently poor at simulating human trains of 
thouRht. I am well aware of the advantages of declarations, and take joy at 
the improvement In control structures of, say Pascal over FORTRAN. But these 
are all Improvments of a detailed, nit-picking sort. What languages should do 
is remove the nits, and minimize the detail you must think about when solving 
problems. What Pascal's data structures, declarations, and control structures 
have done is to make those details more explicit, and thus cleaner. It is a 
real Improvement, but unfortunately leans in the direction of discipline and 
rigidity. 
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BASIC derives from the same traditin as FORTRAJJ, standing out only because of 

^ Lter^^Uve environment. BASIC is a very weaU l-g-^e, and is bc.ng 
shored up in many ad hoc ways. Any student of programming languages can 
easily poke holes in it. Nonetheless, it will continue to be used for many 
vJars ^ich is a tribute to its environment, not its internal design. BASIC.s 
iell-'drserved popularity demonstrates that minimizing programmer -"-J 
ttl is often m^re important, when it comes to purchasing a language, than the 
Jinguage's features as described in the spirit of traditional computer 
science • 

COBOL, with regard to general problem solving, is weak and °' 
programmer timt. Its widespread use is proof that money and ^^^^^^^l 
strategy can be as important as rigor and technical perfection. J ^^^^ J^^^"' 
!nJny study of the design of computer languages, seen a chapter (or even a 
p^rag a J devoted to thi importance of marketing to the J-"f.^^^;;<^;P--/3!;^ 
use of a language. When COBOL was introduced, computers were IBM machines , 
and ;bM pisEld !oBOL for business applications. It actually has features that 
are advantageous in some business applications, but it never -oul6 ha.e 
succeeded on pure .erit. It is not the only product in the world that owes 
its success to PR. 

SNOBOL which has some novel features, was first designed for string 
SNOBOL, whicn nas language. Like many other 

Slng^: s"it wni re in a s::il ani devoted following. Besides the string 
processing eatures. SNOBOL is rather consistent in design, and its program 
~h -rnp^^-f.S% ^Pose .ich 

Tter (bicLse of'its excellent design) became more widely used than one would 
have expected given its intended audience. 

LISP has been given lisp service above. It is an interesting corner of the 
pro ramming universe. aL is relatively efficient of ^^^^^^^^lelZ' for 
suffers from an overdose of recursion and a lack of approachableness for 
common, everyday activities. 

WHY APL IS SINGLED OUT 

interactive human environii>ent as part of its specification. It was years 
ahead in this regard. 

is often ignored. The programming environment ^^^i^;^^,)/ This 

the design (although the assumed environment had a subtle l"^!"*^"^ 
brands Pascal as practically reactionary rather '^an orward ook n . W-^h. 
Pascal's designer, invented it (in his words to foster a systematic 
discipline" of programming that would be impleTnented so as 



M 14Z.3 Page 2 

■■RaskinDoc003 1 075.PICT" 252 KB 2000-02-27 dpi: 300h x 300v pix: 2097h x 3075v 



Source: David T. Craig 



Page 0077 of 0174 



Jef Raskin Document # 003 -- Macintosh Project Memos (February 1980) 



The # Macintosh Project: Selected Papers (14 Feb 1980) 



of 171 



efficient on presently available computers". Do we want to impose a 
"systematic discipline" on the purchasers of personal computers? The very 
opposite is true. Are we really concerned with saving the computer 
occasional microseconds? No, we are concerned with saving the human hours of 
thought and work. 

APL, from its very inception, was interactive as far as a Selectric terminal 
would allow. The human being was treated as supreme, the machine as his or 
her servant. I, being a human and not a machine rather prefer this 
orientation. 

In a number of ways, such as consistency, elegance, and power at handling 
array and matrix structures (of numbers or strings) APL is unmatched. On the 
other hand, APL uses a eccentric notation replete with Greek characters and a 
hodge-podge of unique symbols that make it look very strange indeed. Iverson 
was trying to invent a new notation for mathematics, and mathematicians never 
quail at creating obscure symbols. This notation has been a millstone about 
APL's neck. There is also a feeling that APL works from right to left, which 
people find strange. This accusation is true, but Iverson was only being 
consistent where most of us (and most of our programming languages) are 
Inconsistent. For example, look at expressions such as 

SIN (TAN (COS (3 * (PI/2)))) 

To evaluate this, you start nearly at the right, evaluate PI/2, then multiply 
it by 3, then take the cosine, then the tangent and finally we get to the 
left and take the sine. See! you do work from right to left. 

Iverson, realizing how troublesome the rules of precedence are (he is so 
right, as anybody who has taught programming knows), and being consistent, has 
everything evaluated from right to left in expressions. And APL is almost all 
expressions. As a consequence, APL is easy to teach, easy to learn, easy 
to parse, and looks most peculiar to people brought up on other computer 
languages. APL is also notoriously slow to execute, and until Abram's work, 
it seemed impossible to make it efficient. 

With these black marks agrlnst it, it is only APL's extreme learnability , 
interactive environment, great power, and human progra.-ming speed that have 
kept it alive at all. 

Another comment that one often hears is that an APL program is unreadable, 
undocumentable, and only "can be used by the person who wrote it. All this is 
usually true. Of course, if the main use of a personal computer is for "throw- 
away" programs that are used but once, or perhaps only a few times (and this 
is often the case) then these objections have little force. 

These problems are not inherent to the idea of using expressions as does APL. 
They are partly due to the style in which APL is taught, and mostly due to the 
particular embodiment of the language, not to its concepts. Host APL 
programmers take little trouble to make programs readable, as there is a 
temptation to do as much as possible in as few symbols as possible. The 
mechanism for introducing comments is extremely difficult to type, and its use 
is not encouraged by any books on the subject. Most of Iverson's pamphlets 
don't even mention comments. 
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Given the good and bad of APL. Apple Is an attempt to keep the g°od. 
arctangent functions respectively. 

I must admit that English keywords diminish a languages if ""^^i"";^ 
appeal to a slight dtgrec-BASlC . FORTRAN and Pascal usually keep their 
English keywords in most non-English speaking countries. 

Out of context, some of Iverson's conventions may seem counterproductive or 

1 TK<» riPr<;onal computer s labL bi^it-cn gxvi-^ w r 
even a single letter. The personal cp ccmiments made above 

iiT.zXuZ iTiTz: 'Ai.yT «r.; .T':.u..,.i,. 1.^.^.^== .... 

^,TLl lZ ll te.chlng tlgourcs, professional progr^.Ing practices and that 

lC::/tL"oi::pt ot .r^^cr^re^ .ata ryp.s. His prl.arv .;-;o™a„r ».s 
larpc card-entry, batch processed computer center. Pascal, coo, 1:= 
considerable briUiance. 'in the kinds of world Wirth was — ^^^^^/^J^ 
Prc^l Where hours separate runs and computer time is P-cious a cal^is 
superior to its predecessors (including APL). Just "^"'^^ ^^^^ 
isn't explicitly mentioned, the programmer's environment conditions the design 
of a language to a great degree. 

SOME DETAILS OF APPLE, JUSTIFIED 

Jean Sammet, in her book "Programming Lahguages", after some quite P°-i^i^^ 
Jean Sammet in b enthusiastic about a language that has 
comments, said of APL, L cannot o u.. book "Design of Man-Machine 
this notational complexity " James "^"i"' ^JJ^^X was"ot a professional 
Dialoeues" observed that "It was easy for a person wno was hul f 
Dialogues odsclvcu „ .p, Thpse statements are in contradiction, 
nrnorammer to become hooked on APL. Itiese scaLemem-o 

to novices. 

. API to make it more useable is to reverse 

or.:ror:;:"."ori: - ^"--"r 

t^Sious re<,ui;ement in APL for backspacing and overstriking to create new 
symbols . 

Iv„.on-s ronro.iog u.a of a single -y-""' " "P'tr^„:-°,':^r:L'rh:"°" ' 
r,iLrr.reoi^nratL^rUrr^r:i:Jir--^ ™ se'pa ..e <»crlon 
iZt. A bl^ ol ..th.„r.=.l inslghr is lost In favor of .och ™e„.onlc 
convenience . 
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A ROSETTA STONE 

A nu..e. o. .eas .o. other la...aces Wave .ee. a. ted T.e^^^ 
of Bingle and double quotes frotn f J!f ^ ^ig^t be In-terestinr to 

others that the knowledgeable -^^^^ ,^^^:,!„a chine Dialogues- 

extend the example on page 6A of Martin = J^"^^ ^ „„„ber of 

for inclusion here The sa.e --^^^^^^ ^^rpro^:::! the average of 
i'[[Vro\ ::rr. ^rs!" l^airbut^AppL APL. the Ust has an li.it 

^f 100 Ite^" in Apple and APL there is no li.it beyond the a.ount 
of available memory. 

I have taken the liberty of modernizing the BASIC example, and have written 
examples in Pascal and Apple. 



FORTRAN 

DIMENSION X (100) 
READ (5.10) N, (X(l), 1= l.N) 
10 FORMAT (15, (E15.2)) 
S - 0.0 
DO 9 1=1, N 
9 S •= S + X(l) 
A - S/N 
WRITE {6,20)A 
20 FORMAT (El 5. 2) 
END 

BASIC 



20 S = 

30 READ N 

AO FOR I - 1 TO N 

50 READ X 

60 S -= S + X 

70 NEXT I 

80 A = S/N 

lo2 D™Uhe data on which the program would operate goes here. 
110 and perhaps on the next few lines.) 

120 END 

Pascal 

PROGRAM AVERAGE; 
VAR ITEM, N, SUM: REAL; 
SUM :- 0.0; 
READ (N); 

FOR 1 1 TO N DO 
BEGIN 

READ (ITEM); 

SUM SUM + ITEM 
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END; 

WRITELN (SUM/N); 
END. 



PL\I 

DCL X (100) INITIAL (0); 

GET LIST (N. (X(I) DO 1 = 1 TO N)); 

PUT LIST (SUM (X)/N); 



APL 

+/Xt^X < □ 

(Using p for rho, : for the division sign, <- for the left arrow, and [] 
for the box wc could write it +/Xp:X<-(]. This is done just in case the 
program segment above has not been filled in by hand with the actual APL 
symbols . ) 



APPLE 



INPUT: many. numbers 

many. numbers INSERT + / (many . numbers LENGTH) 
COMMENTARY OK THE LANGUAGES 

Which ones are immediately readable to you depends on what you are used to. I 
remember being told that a Pascal program was really easy to read, even if you 
didn't know Pascal. At the time. I didn't know Pascal, and 1 couldn't read 
it, or even figure out much about it. Now it looks as clear as good English 
to me. So do all the other examples. 

One obvious difference in the examples is their lengths. For the purposes of 

these counts, I have not counted extraneous spaces introduced for the purpose 

of clarity, and all variable names are counted as one character in length. 

The DATA statements in BASIC have also not been counted. Taking a BASIC ^ ^ 

program as oeing of length 1, then FORTRAN is 1.5, Pascal 1.2, PL\I -C5, Apple... ■ - • 

algorithm being represented. Pascal ana PL\I improve strongly as things get 

more complex. FORTRAN, APL and Appl^ (again, relative to BASIC) improve 

slightly with increasing complexity. 

SOME ADDITlCt^L FEATURE 6F APPLE 
(a potpourri of notes to myself) 

Compared to APL, string operations are given more prominence in Apple. 
Graphics are an Integral part of the language, although they do not appear at 
all in APL. Some notations from other languages have been substituted for 
Iverson's, especially notable is the use of Pascal's abbreviated ellipsis for 
the iota. This also allows expressions to be more readable when the range does 
not begin with 1. (Suggestion of R. Kelly). The PROGRAM function is based on 
APL's evaluate. Apple makes decisive use of upper and lower case. 
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THE MACINTOSH PROJECT 
DOCUMENT 15 VERSION 

TITLE: MASS STORAGE PRINTER/FACSIMILE DEVICE 
AUTHOR: JEF RASKIN 



DATE; 



22 Oct 79 



1. INTRODUCTION 

On the lAth of this month 1 was trying to find a less expensive mass storage 
device for the Macintosh project. The bar-code reading wand is one of the 
least expensive computer input devices, but is limited by the operator's 
dexterity. I was also considering the possible requirement for a printer—it 
is agreed that it would be best, although possibly uneconomic, if Macintosh 
could have both a mass storage device and a printer. Any low cost printer 
would have to be a dot matrix based device given the present state of the art. 
I realized that such a printer could print bar codes. 

My next thought was to eliminate the need for operator dexterity. First I 
thought of a plastic guide with slots that the wand could run along. Then, 
considering the sweeping motion of the hand moving the wand through the 
slots, it became apparent that the printer head is already making such a 
motion, and that the wand's sensor should be incorporated into the printer's 
head. It occured to me that the design could also affect read-af ter-write 
checking (a rarity with printers), and that it could also be used as a 
facsimile machine— which fits in wonderfully with Macintoshe's proposed 
communications abilities. 

The possibility of providing the public with a very low cost computer that 
Includes both mass storage facilities and a printer at very low cost is what 
makes this idea Intersting at all. 

2. DATA PACKING DENSITIES 

Since, by using pin-fted or by some feedback from the sensors, the motion of 
the head across the paper can be done with some accuracy, it would be possible 
to have more than a simple bar code, and the head could read a number of bar 
codes In one character height— perhaps even read each of, say, eight dots by 
means of eight photo sensors (and, possibly, a bar-shaped LED to provide 
constant local Illumination). This provides (given a 5 by 8 character 
matrix) 6 bytes in the space of one character. Given compression due to the 
fact that pages of a document are not filled uniformly, this means that a 
document could be stored in 1/8 the number of pages it would take to print it 
In natural language form. 

If 80 characters can be stored across the 8 1/2 inch page, and 68 lines of 
such characters fit into the 11 Inch height, then 32640 bytes can be stored on 
a standard page, with reasonable margins. This means that the 64K memory of 
the Macintosh will fit on a bit over two pages. If, as Victor Bull indicates, 
a few more characters can be put on a line. 64K bytes could fit on two pages. 
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3. DATA TRANSFER RATES 

«.no the d.t. packing d.„,.t.es Indic.tc. hero «>■ 'lll\\f^''^l''Jl 

the data in and data out rates will be equal. At one line 

480 bytes per second, or 28.800 bytes per minute. It would take 

„lnute^ at this rate to dump or fill the entire 6AK memory. 

4. POSSIBLE OTHER TECHNOLOGIES 

tU wire in a suitable holder. 1 found ^^^^J'^^fJ/^J/^,, ^.^ms an unreliable 
on the burned areas. However, it is a spotty exiec . 
basis for a mass storage device. 

approach, excluding the cost of the paper. 

5 USE or PRINTING PRESS FOR DISTRIBUTING SOFTWARE 

software. The use of a ^csistan benefits of an optical reader are 

(although - wel bf Jhe^rtrongest motivation to usin, a 

;rinrer/r;ade^; sfnce soJtiLe ^plication and distribution is a ma.or problem 
at the present time. 
6. LIMITATIONS ON ITS USE 

U Clear .h.CK„ such a device -^'f^^''"' "f^.r/^ra'cln'tLrclLf 

= finnnv disV would be seen as an inducement to purchase a 

roi:^c^! '^Tht'potentially low cost is attractive but ope rat jon^ a^^^^ 
printer/reader would be clun.sy jJr fu6 inserting the written 

reading would require removing f /.f^.^rhr/the paper could bo 

paper. Changing back would ^\^\.'^'"i^""%^e desirn largely self-loading 
fed through instead of pulled back. Making the design & / 
could eas'e this problem, although paper handling - ^PP^^ ^" 
engineering problem, considering some of the printers I have 

unlike a disk, it would be complicated to use a P^^-^^.^r/ecrioral^^^^r 
intermediate results (although not ^"P^"^ f,:;,"„?chi d ^'l? Luld be 

;r::ti::iTn^t.rr:fei^rarcrir ::or::rL. P^ogram and data 

distribution. 
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The major question is: vould the cost advantage, software distribution 
advantages, and facsimile ability ovcrueigh, in the user's mind, the 
difficulties caused by having to use the device as the sole mass storage 
medium in a personal computer system? 

7. MECHANICAL DIFFICULTIES 

There are a numbtr of engineering questions that have to be answered before it 
Is knovm if this technology is practical. The maximum data transfer rates and 
packing densities cited above, if achieved, are practical. Much less than 
that, even by a factor of two, and the concept becomes too clumsy. 

7.1 Accuracy of tracking, between writing and reading. 

At 12 pitch, the width of a character, including the intercharacter space, is 
0.083 inches. The width of a single dot is O.OIA inches. Assuming a 5 by 7 
character in a 6 by 6 matrix, assuming 1:1 aspect ratio for the dots, and 
assuming a reading circle of 0.005 inches, the maximum absolute positioning 
error is plus or minus 0.01 inches both horizontally and vertically. While 
these assumptions may not be exact, this is certainly in the right range. It 
Is also in the range where the humidity coefficient of expansion of the paper 
becomes a problem. Accuracies on this order are not possible with a friction 
feed paper drive. 

7.1.1 Pin feed 

With pin feed, absolute paper positioning within 0.01 inch is possible 
assuming dimensionally stable paper. Unlike plotters, which re-draw over the 
same surface during a short time interval, it can be expected that records 
written with the printer /writer may be read from minutes to months later. 
Humidity and temperature changes over longer time periods can change the 
dimensions of the paper to a sufficient degree that even pin feed may not 
assure 0.01 inch absolute positioning. 

7.1.2 Optical feedback tracking 

It should be possible to place a horizontal line segment at each end of every 
printed line. If a stepping motor was used for paper feed, controlled by the 
sensors on the head, then absolute vertical alignment would be assured. 
Horizontal tracking can bp obtained a number of ways. If there was a ninth 
dot, then it could be used in a number of ways. It could be used as a parity 
bit. Another interesting posslblity is that it could be alternated on and 
off, providing an optical clock track that would assure accurate trackinf 
horizontally. 

Paper skew Is probably eliminated to a sufficient degree by pin feed. If 
separate right and left paper motions were allowed (or there were a 
controllable clutch between the left and right sides of the feed) then the 
horizontal alignment marks could be used, along with a sweep of the print 
head, to adjust the paper for any small skew. 

7.2 Accuracy of tracking, between different units. 

Given a feedback mechanism for vertical and horizontal tracking, then 
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information should be transfer rable between different units. The only 
mechanical restraint is that the heads produce the same size dots, within 
rather broad limits, and that the vertical spacing between dots be constant, 
to narrow limits. These last requirements are easy to meet. 

Any non-feedback scheme would probably make the printing and transfer of 
software difficult, or require a much lower bandwidth. The lower bandwidth 
can be obtained by printing codes as bars across the entire height of the 
character, or by some number of vertical bars (each composed of two, three, or 
four dots, for example) in the height of a character. ^ 

7.3 Error rates 

Error rates depend on noise introduced at five points. 

A. Flaws in the paper 

B. Writing errors 

C. Misalignment of the paper 

D. Misreading of a correctly placed dot 

E. Errors made by the electronics 

1 have not made any tests or done any research on the quality control of 
thermal paper. I have examined some samples, and found occasional dark marks 
that might be mistaken for a signal. With a read-af ter-write scheme, and 
software that marks errors and re-writes the correct information, it seems 
likely that this source of errors can, for the most part, be overcome. 

Writing errors can also be caught by the read-af ter-write scheme, and 
corrected similarly. A protracted period of writing errors might cause the 
system to increase the writing current, if this is under software control. 

Misalignment would probably cause gross errors in reading the data. Either 
the parity (If parity was used) or an abberant clock track (if a clock track 
scheme was used) would alert the system, and a messape requesting that the 
paper be reinserted issued. 

A dirty or failing light "source , or an occluded or defective photo sensor 
might cause reading errors. Checksums, and other data checking schemes are 
the only protection against this kind of error. 

Errors caused by electronic malfunction can be caught in the same manner. 

1 can give no estimates of the probable error rates with and without each of 
the various safeguards mentioned. 1 suspect that empirical studies are the 
best way of determining actual error rates. 

7. A Patentability 

It is unclear how broad a patent might be obtained on this concept, if it were 
decided that Apple Computer Inc. had an interest in pursuing it. I have been 
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told that Sphere conputers was thinkine of a device with a sensor on the 
printer head, probably for facsimile use (but, apparently, not as a data 
storage medium). The combination of printer, data storage, read-af tcr-urito 
checking on a printer ,j^and facsimile seems to be unique. Details of 
execution of the device, of course, may bo patentable. 

8. WRITE PROTECTION dir^,-' li >r^ ^ 

It is important to have write protection. In the case of a themal , read- 
before-write design, it would be sufficient to disable printing if the paper 
already had marks upon it. In the case of ED designs, it might be possible to 
do a sense-bef ore-burn. 



9. COMMENTS SOLICITED 



Comments and suggestions are welcome, especially on the marketing 
desireability and the technical feasability of this project. 



FIN15 
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THL MACINTOSH PROJECT 
DOCUMINT 16 VERSION 
AUTHOR: JEF RASKIN 
DATE: 20 Oct 79 

TITLE: An Introduction to the Apple language for Calculator Users 

1. APPLE IS JUST LIKE A CALCULATOR (but, oh, what a calculator). 

Picture a small calculator- There is one number that you can see displayed 
at the top at the top of the calculator: we will call that number the 
"result". On a calculator you press the equal sign or a button marked 
"ENTER" to let it know that you are finished typing for the moment and want 
to see a result. On the computer, you press the button marked "RETURN". 

Since- this is- a written document and not an animated presentation, we will 
need some way to show when you press the return button. So, whenever you 
must press it, we will have the symbol 

[RETURN] 

When the computer presents an result, we will just write the result on a line 
by Itself. For example, if the answer was 98.6, we would show it as 

9e.6 

You can tell that the computer produced this number since it is not followed 
by a [RETURN]. We are now ready to begin. 

Unless the computer is in the process of displaying a result, it is waiting 
for you to type your request. Like a calculator, it is always ready, unless 
it isn't plugged in. 

For reassurance, the computer displays an exclamation point (!) when it 
expects you to type something. A dialog between you and the computer will be 
presented in this document in the style of this example: 

2+3 (RETURN] 

5 

In this example you typed the first line, and the computer responded by 
typing the single number 5. 

The simplest example is where you type a number, and. the computer responds 
with the same number. This example shows that decimal points are 
permi ssib le . 

56.21 (RETURN] 
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56.21 

If you want to add 2 to this, you can type 
+ 2 [RETURN] 

and the computer will respond 
58.21 

You can do subtraction 

- .21 [RETURN] 

58 

and multiplication 
* 20 [RETURN) 
1160 

and division 
/40 [RETURN] 
29 

Let's add one 
+1 (RETURN] 
30 

and then, since this is a scientific style calculator, take the sine of this 
quanti ty 

SIN (RETURN] 

.5 

Or, you could do this all at once, instead of a step at a time 
56.21 + 2 -.21 * 20 / «0 4 1 SIN (RETURN] 
.5 

2. A COMPARISON WITH SOME OTHER COMMON METHODS OF WRITING EXPRESSIONS 

An essay for experts. 

In ordinary computer languages, a combination of operations and numbers (or 
names that stand for numbers) ie called an expression. The same is true 



'■RaskinDoc003 1 086.PICT" 82 KB 2000-02-27 dpi: 300h x 300v pix: 2039h x 31 80v 



Source: David T. Craig 



Page 0088 of 0174 



Jef Raskin Document # 003 -- Macintosh Project Memos (February 1980) 



The * Macintosh Project: Selected Papers (14 Feb 1980) 



8^ of 171 



here. The difference Is that the expression above would be vnritten 
SIN (((56.21 + 2 -.21) * 20 / 40) + 1) 

in most computer languages. The reason it is different here is that this 
language is much simpler, and works lil.c a calculator. You do not have to 
remember any rules but one: START AT THE LEFT, AND WORK TO THE RIGHT. You^^ 
can use parentheses if you wish, but there are no "hierarchies of operators 
to remember. To write an expression to solve a problem. Just ask yourself 
what is to be done from first to last, and then type it in~in that order. 

In RPN (Reverse Polish Notation), used in some calculators, the expression is 
56.21 E 2 + .21 - 20 * 40 / 1 + SIN 
where E is the "enter" button. 

In APL (Iverson's "A Programmine Language") it is (since this font doesn't 
have the proper division sign, forgive us for using $ for division in this 
case ) 

lo(((56.21 + 2 - .21)X 20 S 40) + 1) 

lo is how APL indicates the SIN function. 

The usual hierarchical schemes begin to collapse when the number of operators 
gets great. For example, in Nicklaus Wirth's Pascal language, the expression 

3 + 4 > 8 

is ill-formed, since the logical operators have higher precedence and you 
can't add 3 to FALSE. But in inost BASICs (Beginner's All-purpose Symbolic 
Instruction Code, by Kemeny and Kurtz) that same expression is legal, and 
evaluateb to FALSE since arithmetic operators have higher precedence. The 
only precedent (using the word in its legal sense) for hierarchy in operators 
comes from matliematics where there is only the precedence of mult ipicat ion 
and division over addition and subtraction. It arose there only as a 
shorthand. As RPN, APL and this Apple language have found, the elimination 
of hierarcliies of precedence contributes greatly to readability, simplicity 
memorability and consistency of a language. It also makes expressions 
shorter, and easier to type. 

3. Document 14 contains the full details of the rest of the Apple language. 
This document demonstrates how easily the Apple language can be introduced to 
users of calculators, and gives a comparison of various methods of 
expressions . 

An article by Backus in a recent Communications of the ACM (Backus of BNF 
fame, now employed by IBM in San Jose) points out that expressions are easier 
to comprehend than programs. He suggests that the languages of the future 
will have their structure embedded in expressions, and points to APL as being 
a step in that direction. Apple does not extend the power of expressions ^ 
beyond the scope of APL's uses of expressions, and does not forward Backus 
ideas. It just makes these ideas more accessible. t-ia/I^ 
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PROJECT MACINTOSH 
DOCUMENT 17 VERSION 

TITLE: REPORT ON THE HPAIC AIID SHARP 5100 CALCULATORS 
AUTHOR: Jef Raskin 
DATE: 27 Oct 79 
1. HP 41 C 

The HP 41C is a general purpose, hand held, prlnary battery operated 
scientific calculator. It sells for $295, or less. It is slightly smaller 
than their original HP35, and the styling is still the classic wedge. 

1.1 DISPLAY 

The display is a 24 character LCD 14 segment alphameric display. Generally 
is very easy to read, however some lower case characters, such as "c are 
unrecognizable until you have a bit of experience interpreting them. This 
suggests that a segment type display is probably inadvisable for a general 
purpose computer system where upper and lower case letters must both be 
displayed. 

The visual clarity is excellent, with the letters being a dense black on a 
silver-white background. 

Information can be scrolled right and left. 



It 



1.2 KEYBOARD 

The keyboard is typical HP, with excellent feel. It is simpler than some of 
the other keyboards of equally complex products, since many of the alternative 
uses of the keys are under software control. Pressing a key and holding it 
reveals on the display, in letters, the functions It will perform. 

The complete uppercase alphabet appears on the keyboard, along with some 
punctuation. 1 found It difficult, without practice, to form words. This is 
especially true due to th'e Irregular spacing and size of the keys, which have 
been optimized for calculation. 

The fact that the keys have many functions, depending on your programming, and 
what modules have been inserted, makes this calculator the least mnemonic of 
any of the HP series. On the other hand, its power is considerably greater. 
Legends appear on the top and front of the keys, as well as on the keyboard 
panel. 

1.3 ALPHAMERICS 

The HP 41C is clearly a digital computer in almost any sense of the word. You 
can give variables, subroutines and statements alphanumeric labels (which is 
more than you can do in BASIC!). You can compare strings for lexicographic 
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1.4 PERIPHERALS 

„ „ rft^n-i look like a c«.p«t.r syste. alro.dy, th« .d<lItlon of . printer 

argument for its "cotnputerness". 
1.4.1 PRINTER 

The 2 1/A inch. 24 character, thermal printer, which seems large compared to 
The ^ W* men, , variable intensity control, 

the built in HP printers, e.g. in the HP . printing only on 
and a number of «>des. The n>odes allow "acxng of a program print^^g ^^.y^^ 

demand, or printing at key --"".^"/.^f, °;;es ^p a number of keys on 

-e^::i^u;rt:r: Thei:inrerr:.irtL^rarc:u;or. operLes from rechargable 

NICADs , or from the AC line. 

^i<==>r Hefinitelv superior to previous HP 
The blue colored printing is quite ^^^^^ ' i"'"^^ 5 x 7 dot matrix to form 
calculator thermal printers. The calculator "J" ^ [ 

its characters, with lower case descenders. J J^J^.^^Jf 3^°,^ . but this 

entire character set. The edges of each ^"^"^J^'i^es. It may be 

„ay be due to the very ^ine surface P/P" /.rp^ror in our 'printer, 

worthwhile, as an experiment, to try a sample 01 

1 . 5 LANGUAGE 

f.K:^i:trs:o:lC/.ior Pthe por^rirth^thfrert-cu^Ji^^.^c -^^^^^ 

t-^i- Tsf rprrnr::LrfnTanrng^^:y^data structures. 

The technique of "sneaking" in programming by P^-^J^^^^/^^ l^lTrll^^^ ^ 
calculator has been very effective, and many people l^J^^ " P^°^^^ ^oth 
calculator quite painlessly due to this subterfuge. It is powerful 
a marketing and a pedagog-ical standpoint. 

1 . 6 SOFTWARE 

book with many 

At release, the HP UC came w th ^^^^^^ ^f, .^/^.eluding the inevitable 
application programs from a ^ J^/l^^^ fj^ ^^^^^ appearing on the screen, 
game of Hangman, this time complete with Z^"^, /;^i„ter. HP can be 

!t would not be difficult to ^"^/"^^^/^^^^f.^^^rof their usual software 
probably be relied upon to provide translations J- ^le^trical 
offerings (e.g. Surveying, Navigation f^^-^^'^^rrP^lC aJd reader has a 
Engineering, etc.) rather ^'^l^' f 33 is'possible) HP 67/97 magnetic 
built-in program which translates (as far as is possioi 
card software to HP AlC notation and format. 
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1.7 HARDWARE AND PACKAGING 

I did not physically examine Che construction of this device since it is the 
personal property of Woz. Interestingly, the connectors for the ROM's and 
peripherals seem to be part of a flexible PC board, as are the battery 
connectors. I suspect that the number of connectors required inside is very 
small, and that relatively full advantage is taken of the flex PC board. 

There is some clever user-level packaging here, and each component has a place 
or carrying case. Even the ROM packs and the spare slot covers have a little 
book with formed places for them. 

1-7.1 EMI 

The calculator disturbs some channels of TV reception if it is vithin three 
feet of a top-quality SONY TV. The interference sometimes has the unusual 
apperance of a few lines of widely spaced white dots. An AM radio can pick up 
its operation from a distance of up to 4 feet on some frequencies, and it 
hardly disturbs an FM radio at any distance beyond an inch or two. The case 
is plastic, but it was not opened to observe the amount, if any, of shielding. 

Since HP typically uses CMOS, low EMI would be expected compared to TTL. 

1.8 MANUALS 

There are quite a number of manuals, all printed on heavy coated stock, with 
at least three colors on each page. The instructions are complete and very 
accurate, and the wire-o binding is convenient. The manuals are HP's usual 5 
1/2 by 6 1/2 (as are Apple 's— which copy HP in this respect). There are no 
errata sheets or other loose pages, except for the handy summary cards, 
carefully plasticized. 

While these manuals continue -to be complete and of very high quality in 
layout and appearance, the writing style has lost some vigor compared with 
the earlier manuals. In some places, the choice of words shows a lack of 
care, which has not been evident in earlier HP calculator manuals. 

1.9 SUMMARY 

In many ways, this is the first handheld computer— the distinguishing feature 
being alphamerics. It is well thought out, with the main annoyance being the 
small number of characters on the screen, and the need to type long subroutine 
names (sometimes as many as six characters) to summon certain functions— 
although those functions you use frequently can be reassigned to whatever key 
you wish. Labels are provided for relabelling the keyboard. 

There is some real genius in this machine, and it probably competes for one 
tiny corner of Macintoshes intended market. I am still more concerned about 
any improved versions, and HP's competitors. 

2.0 THE SHARP ELS 100 CALCULATOR 

For §99, the user gets a 7 by 2 3/4 by 1/2 inch scientific calculator. It is 
distinguished by a large number of keys (60) with many unguessable function 
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duly warn against. 

It looks tawdry. Especially since there is a special (kludged) RESET button 

llTlk L use of Which is -. Clearly spelled out in t e ^n^^^^ I^^^ 
suspect that the software can get wedged, and that in some 
button is the only way out. 

2.1 THE DISPLAY 

TM. V.S purchased '"^l"':^ ^.iT.llfAl'X 

.bout 1« point type. Books .re typlc.lly 8 or 10 polot. 

Cl.v.r u.. of th. dot ».trlx .llo»s Sh.rp to pr.s.ht . vide v.rlety of 

-t;r"4ht-rief t! ^'^^^ ^iSi^T^^^'- 

-tr:Ls -hir'tLX:a^re!eS:.n; i::^^^ - 

remainder of the circuitry. 
2.2 KEYBOARD 

The ke,bo.rd 1. . 5»^^«-P=^*«„f ro-^^fu^t^^f ^St'f""""''!"""""' 

with . scientific fonctloi, p.nel off to ^ ^y, 

the .lph.bet .e-ory 'f^'ig '."llS'e e hf "E" 1 old'fLe, th'e "x" In 

;r.!i:r:rtif "j"-irf.."e 5p..nire f.^-f-. -,r.nd"iBr..:r°::" 
:Li°ifs :r:r:^^i."°"!'°?;;B.Ty"h:ty:%^^;i»;/-.'»-" - - 

which numbers will be rounded! 

The keys are brown and silver, with one red and one yellow key. Thelegcnds 
are w^ite on brown, and either black or blue on silver. 

The keys have a <>efinite "fall S^-^f;;,f;'^rt1s"e"er th:n fh^Lj^rity of 
definite as that on the HP b. ^^h the single, phenolic 

calculators. The keys' contacts make <li"" "^^J-^' S.e keyboard la;els are 
based, two-sided PC board, as does the "^^^^^^^f ;3^J^^^y ^sy to find when 
typographically clear, and the grouping does make each Key easy 

you need it. 

2.3 ALPHAMERICS 

J Ai.xriT,rt Pvon if inscrutable as to function at 

^;L:!■'si^y■^h.n:tL:f tJ°~;h'.'." b. typed. ... » co„,„sio„ >.th 
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other symbols is possible. The limited portion of the alphabet prevents this 
device from being used as a note pad. The letters are much easier to type 
than on the HP, being on the tops of the keys — this shows a problem with 
multiple key designators. 

2.4 PERIPHERALS 

The EL 5100 uses primary batteries, and has no provisions for any peripherals. 



1.5 LAMGUAGE 

Here is were this calculator falls apart. There are 10 levels of priority, 
plus parentheses, and some auxilary rules. For example you have to remember 
that the fifth priority is "Multiplication cleared of "X" instruction located 
just before memory or pi." which is three priorities higher than ordinary 
multiplication, but lower than a single term function when preceded by 
numerals, but higher than a single term function followed by numerals. 

While this calculator is far less powerful than the HP AlC, it is far more 
difficult to understand and use. Or, at least, it seems that way. The 
totally Inadequate manual aids and abets the crime. 

Using it as a scientific calculator *rith "normal" mathematical style 
expression input is not difficult, the trouble is that there are many obscure 
gotchas. 

Another example of the kind of rules you have to memorize is the one that says 
"Provided that functions shown in item (5) (6) (fifth and sixth priority] 
above are successively designated in an algebraic formula, calculations are 
performed from the right to the left. The other functions are calculated from 
the left to the right." 

With all this complexity, the machine is not programmable. 



1.6 SOFTWARE 

Without programmability , there is no software. The functions on the 
calculator, besides the usual scientific functions, include combinations, 
factorial, cube root, and the hyperbolic functions; besides the usual 
statistical functions is -a correlation coefficient; angles are in degrees, 
radians and (as everybody seems to do) grads. 



1.7 HARDWARE 

The construction is conventional, and extremely cost conscious, using lands 
the PC board as switch contacts. The case is metal, resulting in no TVI , a 
Interference to a sensitive AM receiver can be detected only within inches 
the front of the calculator. 



1.8 MANUAL 

The manual is dreadful. This may be partly due to translation— ^^e should 
some mechanism to make sure that Apple does not look this stupid in other 
languages — and partly due to a design that makes documentation difficult. 
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booklet has the same fonii-factor as the calculator and is 100 pages in 
length. It is poorly organized and has no index. It is typeset and printed 
in brovm ink. 

This is not the worst tnanual 1 have ever seen, but it renders many features of 
the calculator opaque, even to an experienced calculator and computer user. 
It points out to me the importance of clarity. 

1.9 SUMMARY 

Except for the display, and its relatively sophisticated editing (delete and 
insert) for a calculator, there is little instructive about it. 
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THE MACINTOSH PROJECT 
DOCUMENT 18 VERSION 

TITLE: ON THE PROBLEM OF DELIMITING STRINGS IN PROGRAMS 
AUTHOR: JEF RASKIN 
DATE: 3 Nov 79 

1. INTRODUCTION 

The problem is how to delimit a string in a program. A string, by definition, 
can include any displayable symbols, which usually include- the string 
delimiters. If a string is delimited by quotes for example, then it is 
obvious that a quote that occurs as part of the string may be mistaken for a 
close quote. 

2. THE SNOBOL SOLUTION 

SNOBOL uses two kinds of quotes, single and double, on the theory that any 
string containing one kind would be delimited by the other. To include a 
string such as 

"Don't shoot," he said, "don't! I'm unarmed." 

in a program you have to represent it as the concatenation of the following 
substrings 

'"Don' 

"'t shoot," 

'" he said, "don' 

"'t! I'm unarmed." 



Not a pretty sight. The problem is not quite solved by adding a third kind of 
quote since one can then contrive an example (say, where people are discussinp 
his new kind of quote) that is as messy as the example above. Further quote 
symbols merely exhaust the character set without solving the fundamental 
problem. But see section 5 below. 

3. THE PASCAL METHOD 

The solution chosen by the designers of Pascal (and some others) is to have 
but one kind of quote and to use it twice in succession to represent a quote 
within the string. The messy example above becomes 



■Don' 



t shoot," he said, "don"t! I"m unarmed."' 
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One could do the same designating the double quote (") rather than the single 
quote as the standard quote symbol (Pascal made the incorrect choice, since 
the usual character sets use the same symbol for both the single quote and the 
apostrophe— which occurs far more often in strings than does the double quote. 

Thus Pascal has to use the awkward repeated symbol more often than it should. 

The most annoying aspect of this notation occurs when you are trying to 
produce nicely formatted output, in which case the number of characters is 
distorted, so that line lengths do not appear in the program as they will upon 
output. 

To represent, with this notation, n quotes in a row you use n+1 quotes. 
A. FORTRAN'S HOLLERITH DEVICE 

FORTRAN manages to both avoid the need for quotes and keeps the length of 
strings constant between program and output. It represents the test string 
above as 

A5H"Don't shoot," he said, "don't! I'm unarmed." 

Where the A5 before the "H" means that the 45 characters following it are a 
literal string. This works without fail, but requires that you count every 
character— and there is no room for error. It is flawless from every point of 
view except that of the programmer. 

The "H" stands in memory of Herman Hollerith who was instrumental in the 
development of punched card accounting machines. 

5. COMPOUND QUOTE SYMBOLS 

One can create a large hierarchy of quotes by using a symbol that includes a 
number — in this case the compound symbol is '34'. 

'34'"Don't shoot," he said, "don't! I'm unarmed."' 34' 

In case a string happens to contain a particular compound quote symbol, or 
even a whole bunch of them, there is another quote symbol you can use. It is 
unlikely that a string could be so long that it could contain all possible 
quote symbols. 

6. USING NON-PRINTING CHARACTERS 

A string could be delimited by non-printing characters. This works in all 
regards except that It makes it impossible to tell, by looking at the program, 
if the delimiters are present or not. You might dufine a symbol that can only 
appear in programs, and not in output. This is weak, for example, you can t 
write a program that writes programs (or even have examples to Instruct a 
user in the use of strings). Both of these schemes have to modified by one ot 
the methods already discussed so that quoted strings can be quoted. 

7. USING PAIRS OF ASYMMETRICAL SYMBOLS 

The problems with quotes do not occur with parentheses in expressions for two 



M18.0 Page 2 

■■RaskinDoc003 1 095.PICT" 200 KB 2000-02-27 dpi: 300h x 300v pix: 2062h x 3058v 



Source: David T. Craig 



Page 0097 of 0174 



Jef Raskin Document # 003 -- Macintosh Project Memos (February 1980) 



The # Macintosh Project: Selected Papers (14 Feb 1980) % of 171 



reasons: paretheses have syntactic function so that well formed expressions 
cannot have random or unexpected parentheses; secondly, parentheses cone in 
pairs. It is possible to use symmetrical pairs of quotes. The ASCII 
character set has both " * " as well as " ' ". This allows nesting of quoted 
strings, but since these symbols can occur without structure inside" strinfs, 
an Additional mechanism is required. 

If it could be assured that the quote delimiter symbols would occur only in 
matched pairs inside strings, then there would be little problem. 



8. SUMMARY AND CONCLUSION 



SNOBOL's solution is unsatisfactory in its lack of depth and potential 
operational complexity. The Pascal method seems too ad hoc, and the FORTR/J<" 
Hollerith notation is unattractive in light of the need for an easy-to-use 
language. Non-printing characters are unacceptable, and the use of asymmetry 
does not gain us any advantage. A dual solution presents itself: to use 
simple quotes (") when no problem is engendered by their use. When a more 
complex situation occurs, use the compound quote symbol shown above. 

Formally, the syntax for strings is as follows, where <character> is any 
dlsplayable symbol: (here, the braces are used to indicated zero or more 
occurrences of a syntactic element) 

<string> := "<<character>}" | '<integer l>'{<character>}'<integer 2>' 
The syntax requires that <integer 1> and <integer 2> be identical, and that 



'<integcr 1>' 

not occur in the characters comprising the content of the string. 



Such a syntax can be "fooled" by an occurrence of 



'<integer 2>' 

in the string, so that it is the programmer's responsibility to choose the 
appropriate integer. A compound quote can be parsed easily: 

A. When a single quote is found, not within a normal quoted string, store the 
integer following it. This integer, called X, is delimited by another quote. 
If not, it is a syntax error. 

B. Every character thereafter is stored as part of the string unless it is a 
single quote followed by a non-integer, or an integer other than X in which 
case continue from B.l otherwise continue from step B.2 

B. 1 The quote is part of the string. Continuf from step B. 

B.2 In this case the quote is followed by the integer X delimited by another 
single quote so that the first single quote is not part of the string, and the 
string is complete. Parsing continues from the first character after the 
second single quote. 
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THE MACINTOSH PROJECT 

DOCUMENT 19A VERSION 2 

TITLE: THL MACINTOSH EDITOR, PART A 

AUTHOR: JEF RASKIN 

DATE: 03 Nov 79 

1. INTRODUCTION 

In a personal computer system meant for the general public the design of the 
text editor must be especially approachable and easy and quick to learn and 
use. To this end, an editing system has evolved that is somewhat different 
from the main stream of word processor design. 

2. ORGANIZATION OF THE SYSTEM 

Whtn the computer is first turned on, it is executing some program. As 
supplied, it powers up in the editor. There are a few editor options that 
make it "smart" with respect to the task that it is to do— for example in 
editing a program — ^but its capabilities remain basically the same. The 
options might include some of: the "Apple" calculator language, BASIC, 
Pascal, the Personal Communicator and the Personal Assistant. You can 
make any of these or any application program the default upon system power 
up. 

The editor abilities are common to the entire system (except during execution 
of application programs). Iq///) 

There are two special keys on the keyboard. On Sara they are Apple 1 and 
Apple 2. For now we will call them HELP and CHANGE. 



3. THE EDITOR, A FIRST LOOK 



The design is t.'.sod on the Bannister & Crun text editor- It is aimed at the 
personal creation and editing of documents rather than the typing and editing 
of documents created by others. Most commercial word processors are 
optimized for the latter. task. 

3.1 INITIAL APPEARANCE TO THE USER 

The system is very easy to learn and to teach since it merely simulates a 
rather smart typewriter. It requires no commands to be used as a simple 
editor. You type, and what you type appears on the screen. Shift Space is 
the destructive backspace, and the keyboard has auto-repcat. With no 
further information than this, you can create documents more easily than 
with a conventional typewriter. 

3.2 INITIAL STORING OF A DOCUMENT 

What is kept on the mass storage device is not a copy of the document as you 
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set it on the screen, but a keystroke trail of the document. At the cost of 
(usually) very little extra space, this is a far more powerful iten to 
store. It not only represents the current state of a document, but every 
previous state as well. You will have the option (as we shall see later) of 
storing the final result of following the trail, as well as the fonnatted 
version of the file. (Note that a docunient that is built out of many copies 
of a set of items Is stored more compactly in trail form than in literal 
f orm. ) 

Another useful fact about the keystroke trail is that it never need be re- 
written but only appended to. This is be done automatically as soon as a 
given buffer fills. What you see on the screen, of course, is not the 
trail, but the current state of the document. 

As far as the you are concerned, no thought at all need be given to the 
storing of a document. Given the "soft off" feature, and the automatic 
dumping of the keystroke buffer, the current document is always placed into 
non-volatile memory. Only a power failure (or other act of God, such as the 
dog chewing up a disk) can cause loss of data—and a power failure will lose 
at most one buffer (probably about bytes). 

You will have to give some thought to filing things away when a new 
document is to be started. Pressing the HELP button obtains a menu (at the 
bottom of the screen, called the "menu area", which is scrolled up to 
accomodate it). One Item on the menu during editing is to file a document. 
The system asks for a name, and a description (which is optional)-. When 
given the name (and the description) the keystroke trail is squirreled 
away. Later we will discuss retrieving files, and keeping versions 
straight. 

3.3 INITLAL PRINTING OF A DOCUMENT 

There is a default formatter, in the system. Another item on the HELP menu 
during edits Is to print a document. With no further instructions, standard 
mareins. pagination and font selection will be operative. The document 
prelentiy being edited (what UCSD Pascal would call being "in the WorkfUe ) 
is the document that will be printed. Later we will see that it is possible 
to format and/or print other documents. 

3. A SUM>1ARY OF FIRST USER INTERACTION 

With but a few minutes of instruction from the computer (or, at worst, a few 
minutes reading the manual), you (or even a naive user) will be able to edit, 
store and print a document satisfactory for many purposes. To get further 
options you will have to press HELP rather than RETURN after selecting 
an Item such as PRINT from the edit HELP menu. 

In neneral. the menus will be very simple, and at each stage selecting an 
item and pre.aing RETURN creates an action. Selecting an item and pressinc 
HELP gets a tub-selection or further details on the item in the original 
menu if no sub-selection is possible. 

Note that all Apple-supplied programs for this computer will have to adhere 
to this style of user interaction. 
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U. THE CHANGE COMMAND 

During editing, you can press the CHANCE key. The botton line 
immediatuly shows this format— the cursor position is indicated by [1 

CHANGE II INTO 

The cursor In the text stops flashing, and the cursor in the bottom line 
flashes. 

A.l USING THE CHANGE COMMAND WITH LITERALS 

You type the word or phrase you wish changed (called the "pattern"), and then 
press the CHANGE key again. The screen shows (for exanplc) 

CHANGE frugile INTO [] 

Now you can type what you want the string changed into (called the 
"replacement"). The cursor in the text moves to the point at which it found 
the example for which you were looking, and highlights it. 

[The CHANGE instruction is operative, by using SHIFT CHANGE, even during a 
change. ] 

The search proceeds from the current text cursor position and proceeds 
backwards, wrapping around if necessary to complete the search. You nay 
think it strange that the search is backwards, however in creating a 
document, this is the direction most often needed. 

If you want to change the instance of the pattern (continue searching), you 
use the HELP key which has this item on the menu. Usually you will include- 
enough context to avoid needing this feature (which should not be introduced 
at first). 

Once you have found the desired instance of the pattern you can complete the 
command, which becomes 

CHANGE frugile INTO fragile 

and is terminated by a (third) press of the CHANGE key. 
(Were you expecting, maybe, "frugal?) 

When the instance of the pattern in the text is found (it was, you remonhor, 
highlighted) It is replaced by the replacement string. One HELP option is to 
do It again, another is to do it for every Instance. Again, note that you 
need not use any HELP options in order to do most editing, nor do you need 
them to use the simpler method. 

If the INTO field is empty (it is terminated by a press of the CHANGE key) 
then this command is a deletion. This is most natural, and avoids having a 
separate instruction or button for deletion. 
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4.2 MOVING THE CURSOR 

Vaien an instance of a pattern is replaced, the cursor is left just after the 
replaced section. Typing will appear at the cursor location — it is an 
implicit insert. The instruction 

CHANGE run INTO run 

serves to move the cursor to the most recent instance of the string "run". 
(It might be into the middle of the word "brunch" for exanple. If you wanted 
to find the word "run" you micht typo " run " for the pattern.) 

The empty string is understood to occur at the end of the text, so that 
entering no string for the pattern (i.e. pressing CHANGE twice in a row) 
places whatever would be put as the replacement at the end of the text. 
It thus becomes quickly learned that three presses of the CHANGE key moves 
the cursor to the end of the text. TVo presses does the same thing, except 
that the text you want to add appears as the INTO portion of the bottom 
of the screen. 

The menu area of the screen can grow as needed until it is the entire screen 
or more if necessary. 

A. 2.1 THE EFFICIENCY OF THIS METHOD OF MOVING THE CURSOR 

Interestingly, experience with an editor of this design has shown' that you 
can unabiguously specify most instances of patterns in natural language text 
with three chffacters. With the wild cards in 4. A below, this means that 
moving the cursor is usually faster using this method than with cursor motion 
commands. 

In most programming languages, the text is more repetitious, and you will 
often need to specify three or four tokens to move the cursor. A compact 
language such as that suggested for the calculator language is nearly ideal 
for this editor. (See document MIA) 

The four normal cursor control buttons or some equivalent device is also 
expected to be available. 

A. 3 USING RANGES IN THE CHANGE COMMAND 

A mechanism for specifying and moving large portions of the text is provided. 
The syntax is much like that of Pascal. (This concept has appeared in the 
text editor described recently in CACM (find reference], however it was first 
used by the author some ten years ago, albeit with three dots instead of 
two.) 

A. 3.1 USING THE CHANGE COMMAND WITH RANGES 

Changing a large body of text can be tedious unless a range specifier is 
allowed . 

CHANGE you m.-ker INTO expletive deleted 

Will take the roost recent occurrence of "ker" and then find the firet 
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occurrence of "you m" prior to that. The periods that appear in the pattern 
are obtained via the HELP key, and are not ordinary periods. 

If the INTO field Is enpty, this mechanism allows deletion of large portions 
of text. Since the text is highlighted, and since commands can be aborted by 
means of the HELP key, errors can be avoided. 

4.3.2 USING A RANGE AS THE REPLACEMENT 

When a range is specified as the replacement, the text specified by the 
replacement range is moved into the place specified by the pattern. This 
allows blocks of text to be easily moved. A HELP option for the pattern 
allows the movement to be to the current cursor position. 

There are a number of techniques that users quickly develop that make this 
command structure more useful than it might appear to people unused to it. 




THE MACINTOSH PROJECT 

DOCUMENT 19E VERSION 

TITLE: THE MACINTOSH EDITOR, PART B 

AUTHOR: JEF RASKIN 

DATE: 03 Nov 79 

it.U USING THE WILD CARDS 

4.5 SCANNING THROUGH A DOCUMENT (and grammatical positioninrJ (to beginning 
and end) 

4.6 UNDERLINING AND OTHER MODIFICATIONS OF CHARACTERS 

4.7 OUTPUT FORMATTING {& widows and orphans) 

4.6 ABILITY TO UNDO MISTAKES (and the lack of need to protect areas of text) 

4.9 THE MENU AREA (and enviornment setting: headings, footings, margins, page 
cumbers, footnotes, paragraphs) 

A. 10 HANDLING USER ERRORS 

4.11 TABS AND COLUMNS 

4.12 MACROS 

4.13 DIFFERENT PRINTERS 
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5.0 PROPERTIES OF THE EDITOR 

This is certainly one of the "what you see is what you get" variety, editors . 
It has roughly the same power as the UCSD and Apple Word editors. Each of 
these editors has some "features" the other lacks, but they can all do about 
the same job. Apple Word is easier than our other editors to use, and I 
suspect the present editor may be easier still. 

5.1 SIMULATING THE BiC EDITOR ON AN APPLE II 

This system can be simulated with CTRL C and CTRL D for the CHANCE and HELP 
keys. On most sytems CTRL H is the destructive backspace, if SHIFT SPACE is 
not available. 



5.2 MANUALS, BOTH ON- AND OFF- LINE 



6. IMPLEMENTATION 
6. 1 PERSONNEL 



6.2 IMPLEMENTATION METHODS 



6.3 SCHEDULE 



7. FUTURE EMBELLISHMENTS 

8. ENGELBART STRUCTURE OF A TEXT 
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THE MACINTOSH PROJECT 

DOCUMENT 20 VERSION f 

fltCONFIDENTIAL 

TITLE: THE MACINTOSH DISPLAY Jef Raskin 

AUTHOR: JEF RASKIN 
DATE: 12 Dec 1S79 
ABSTRACT 

Many display technologies have been studied. Regretably, all but the CRT are 
as yet either not ready or too expensive to consider. Human factors studies 
suggest that a screen should have from 25 to 30 dots per centimeter to make 
the displayed characters appear continuous. More is uneconomical. Fewer 
make the dots visible to the average reader at normal reading distances. 
Programming considerations show that a 256 by 256 display is desirable in 
terms of program speed and efficiency. These factors fit nicely with a small 
CRT with a viewing area of from 8.5 by 8.5 cm. to 10 by 10 cm. 

The photographs on the next page show a simulation of the proposed screen at 
actual size. In printer's terms, the characters are in an 8 point font, which 
is larger than the print you are reading now. 

Portability and cost constraints, combined with the expected application 
areas of Macintosh, preclude color. 

















; w -J. ^ ■— 



Ihis IS a simuljlton of the proposed Macinlosh scr«n. K has >he s««f 
horirontjl t jsalulion, bul less vertical resolution: Ihe actual vertical 
si:e will be 25 lines of text (256 pixels). Using this font, an average of 
ovet 76 characters can be displayed on a line, lo facilitate columnar 
display of data, the digits are of coiistant width: ei23'15e?8^. 51 num- 
er ats can be displayed on a single line. The character set, which is full 
flSi II, is: ahcdefghijklmnnpqrstuvwxgj RBCDEFGHlJKLMNOPaRSlUV 
uixYZ |!"«^3:&'()* = '''{)-*'''<>^:-e"t];/.,plus 
the digits shown above. 

Ihe thai acter s in this photograph are almost exactly the size they will 
be on the pr oposed Macintosh display. 

this photograph is confidential and proprietary property of Apple Com- 

Inc. It may not be exhibited outside the company without aulh- 
ifwalifln. Jef Raskin, 13 December 1979 
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Urinny rrsW»ti«i, W less vertical residsliM: IW ad«J ferbci 
s« **i ke 25 liws if lexl (256 pixels). l>siw| this m itrrw ^ 
wm 78 cfcanrfers cm be kplaijeJ w a few. !• facSUe cdUnr 
fe^iTMaJkeMs are if cmslairf wiAfc 8125156783. 51»- 
erak cai te Asriaid ■« a W. The ckaracter set, wfcirt is fdl 
ftSCIl is: akie3ijkl«««,mrsluvwx,2 fiBCDEFGHIJKLMNOPaRSTW 
UKYZ|!-t$Zt«'()* = '"{}_*?<>^:-e"t];/.,|fc 

Uk sUwt aiwve. 

TW cbrarfers « litis pMafr^ are aUt^ exaAbi Ike size liq *^ 
k M Uk p-ipaseJ MacmtBsh iispby. 
This is I sifflulalion of Hie 256-ilol wide Macinlosh screen. Sace i k 
being simulaled on an Apple 11, Ihe full 24 lines cannol be displayed. On 
this screen, using the fnnl at which you are now looking, an average of 
over seventy characters per line can be displayed in normal Engli^ text 
applicitions. Ihe numerical font is constant width: 111122223333W 
12315e.78% 12345e78$0 1234567898 1234567898 12345678% 1 
Fis demonstrated here, 51 numbers can be displayed across the full widt 
h of tht 5cr (pn. ahcdBfnhiiklmnopqrsluvwxyz , . / ; [ 3 C - : N 
1 ! ■■ « 3 7. t. • O * = ^ { } ♦ ? X fiBCDEFGHI JKLMNOPaRSTUVWX 
VZ. Ihii comprises the complete fiSCII character set. Here is some 
F'astilcode. . — 



li*^<, U ir*ilckin) or 



function GCOCfirstnumber, secondnumber: inleger): integer; 
var remainder: integer; 

begin 

if firslnumber < secondnumber 
Ihen 

GCO := GCDCsecondnutnber, firslnumber) 
else 

'"•remainder := firslnumber MOD secondnumber; 
if remainder = 
Ihen 

GCD := secondnumber 

GCO := GCOCsBCondnumber, remainder) 

end 

end; 



b»<^ * Ki^tf look 
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1. INTRODUCTION 

The various questions about the nature of Macintosh's display have been 
largely resolved. This document sumraarizes the research done to date, 

1.1 BUILT-IN DISPLAY 

In Document M2 , a number of areas of concern about the display were brought 
forward, notably absent was any mention of predictability. One of the main 
weaknesses of the Apple II was the display limitations imposed by the 
variability of external displays that might be attached. We were iorced to 
design for the lowest common denominator: a poor color TV. In order that 
Macintosh be self-contained and to give us control over the quality and 
specifications of the display, it will be mechanically and electrically part 
of the main package. 

1.2 BIT-MAPPED ARCHITECTURE 

To permit both graphics and text, a bit-mapped display has been chosen. 
Experience has shown it to be both a cost-effective technique with few 
limitations in applications. In fact, the bit-mapped display on the Apple II 
is certainly one of the reasons it has remained so popular- 
La MARKETS SERVED 

The display resolution proposed below will satisfy the needs of most ^^o^ 
marketing areas such as personal use in business, science, industry, and the 
hobbyist. A small problem with some potential educational applications is 
discussed below. 

2.0 DISPLAY TECHNOLOGY 

A number of technologies have been explored. It is clear that Apple must 
follow and perhaps even develop one or more of these (or even other possible) 
display technologies. 

2.1 LIQUID CRYSTAL 

Two avenues have been explored, direct LCD viewing and a small LCD "sl'ide" 
using transmitted light onto a screen. The problem of multiplexing an LCD 
matrix of the required resolution at any size has not been solved at the 
present time. When and if this technology matures, its small size, light 
weight and low power consumption will inspire many products—including a 
redesigned personal computer. 

2.2 PLASMA AND SELF-SCAN PANELS 

At present this attractive technology suffers from excessive cost. A 256 by 
256 display without electronics can be purchased for $100. Paul Baker has 
suRpested that we could produce the panels (with moderate resolution) m- 
house at reasonable cost, but at present this option has not been studied. 

2.3 LIGHT EMITTING DIODE ARRAYS 
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These have just become available, and are being applied by tl)e military. Tiny 
are too expensive to consider at the present time. There are some concerns 
about power requirements as well. 

2.« FIELD EMISSION DISPLAYS 

While a promising technology, it is unlikely to be ready in time fpr the 
present project. 

2.5 ELECTROLUMINESCENT PANELS 

Sharp and Hitachi, among others, have exhibited such displays. They are not 
yet available commercially. 

2.6 LASER SCANNERS 

An optomechanical scanning device was considered but abandoned on the grounds 
of mechanical difficulty and questionable maintainability. 



2.7 CRT 



CRTs are undesirable on grounds of size, weight, fragility and the high 
voltage necessary. Nonetheless, nothing approaching their low cost and ready 
availability exists. Two approaches have been considered: direct view and 
projection. 

2.7. 1 PROJECTION CRT 

Cur consultant, Alan Stein has been Investigating this possibility. At. 
present there are possible difficulties with brightness and contrast, and it 
is not clear just how available are the extreme brightness CRT's required. 
In any cast these projection CRTs are about 7 or 8 cm in size, which is quite 
close to the size of the direct view CRTs being proposed. Of course a 
projection CRT would give us a larger screen, but in that case more resolution 
would be required to meet the goal of 25 to 30 dots per cm. (see section 3 
below). 

Use of a projection scheme is very attractive since it allows a folding 
display and thus a compact, lightweight package. On the other hand, it 
requires more mechaical assembly, optics and other parts that would increase 
maintainance problems. Keep in mind that a projection CRT system has all the 
complexity of a CRT, and 'in addition has optical and mechanical components. 



2.7.2 DIRECT VIEW 

A direct view CRT has the advantage of simplicity. Such a CRT may either be a 
flat screen display or a conventional (and awkward) bottle type CRT. 



2.7.2.1 FLAT CRT 



Allen Stein has been investigating these, such as the Sinclair rectangular 
tube. As with many other promising technologies, this one is, at present, 
merely promising. It does not seem that such a CRT will be prepared in time 
and at a competitive price, although it is by no means out of the question 
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that given adequate incentives it could be done. 
2.7.2.2 CONVENTIONAL BOTTLE 

There is no doubt that the conventional CRT is an excellent candidate for 
Macintosh's display. 



2.8 HARD COPY AS A DIGPLAV MEDIUM 



Mike Markkula has suggested that the possiblity of having no volatile display 
be investigated — or, if one could be invented, a volatile hard copy display be 
devised. The requirements for too many applications require a fast-changing 
display, and no known technology (unfortunately) will poniiit updating a piece 
of paper or other hard copy medium at anything near the required rates. 

3.0 HUMAN FACTORS 

The main factors with which we are concerned are resolution, flicker, size, 
color, brightness and contrast. 

3.1 RESOLUTION BOTH GRAPHICAL AND OPTICAL 

We have two resolutions, the program resolution or number of dots comprising 
the picture, and the resolution of the screen as seen by the human eye. For a 
given screen size, fixing one determines the other. Experience and a number 
of studies have shown, as stated above, that characters composed of dots seer, 
continuous at between 25 and 30 dots per cm, and their edges seem smooth at 
above 60 to 90 dots per cm. Careful inspection of a character will reveal 
jagged edges until a dot density of 150 to 200 dots per cm. is achieved, 
(these studies assume round dots just touchinj' at their edges in a square 

packed tesselation) . 

For our purposes, the formation of characters that appear continuous, we 

should strive for a screen dot density of 25 to 30 dots per cm. If we choose, 

for the purposes of portability, a A or 5 inch CRT, then the desired density 

is obtained with between 200 and 300 dots across the tube. Programming 

considerations on a byte oriented machine suggests the convenient figure of 
256 dots. 



3.2 BLACK ON WHITE VS. WHITE ON BLACK 

The work with a number of commercial word processors (e.g. CPT, experienceat 
Xerox PARC, and also the photographs on page 2, suggest that black on white, 
as used nearly universally on the printed page, is to be preferred. 1 suggest 
that this not be made a user option. 

3.3 FLICKER 

A light-colored background makes flicker more noticable than does a black 
background. User preference indicates that a white phosphor is to be 
preferred over the slower green. 50Hz seems to be a bit slow, so it is 
suggested that a higher rate be used. 11, as proposed here, no attempt be 
made to have standard video, and we do not have to be PAL or NTSC compatible, 
than any refresh rate above 50Hz would be acc-eptable, and wc can choose some 
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convenient eub-multiplt; of the system clock. 



3. A COLOR 

Considerations of cost and portability practically exclude color as even an 
option on Macintosh. The areas in which it is intended to be used, 
fortunately, do not rely as heavily on color as would a home or game orientc-d 
machine. 



A.O COST 

Gary Baker estimates that a CRT system that can display 256 by 256 dots might 
cost in the §20 to $30 range. 

5.0 SIZE AND WEIGHT 

The CRT will be about 6 inches in width, 5 high, and between 6 and 8 inches in 
length. The entire CRT and associated components will weigh between one and 
two pounds. 

6.0 MEMORY REQUIREMENTS 

A bit mapped 256 by 256 display requires exactly 8,192 bytes of memory. 
7.0 PROBLEMS WITH NON-STANDARD VIDEO 

While non-standard video has some advantages, such as extra vertical 
resolution and electronically convenient refresh and scanning rates, we lose 
the ability to usi- inexpensive slave monitors. This hurts us most in the 
educational arena whi^re large monitors are especially useful. It also makes 
dealer display more difficult. 

On the other hand, the enhanced quality of the image and lower price permitted 
by non-standard scanning may be a greater asset. 

8.0 POWER CONSIDERATIONS 

A conventional CRT and associated electronics adds a load of between 9 and 12 
watts to the system. 

9.0 FONTS, DOMESTIC AND FOREIGN 

As shown by the photographs, a small CRT. with the appropriate fonts, can be 
extremely readable. The large number of lines will allow the special 
characters and diacritical marks demanded by non-English languages. The 
software engendered by this approach will be very flexible in these regards. 

10.0 APPENDIX: FONT GENERATOR PROGRAM 

This is a simple program that generates and allows primitive editing of a 
proportional font. The one shown is called "Two-bit Gothic Proportional 
Condensed" and was designed by the author to demonstrate how readable a truly 
compact font can be. 
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DOCUMENT 21 VERSION 

TITLE: BEYOND WORD PROCESSING: THE ONLINE TEXT SYSTDI 
AUTHOR: DAVID CASSERES 
DATE: 3 October 1979 



The purpose of this paper is to stir up some interest in the 
possibility of an Apple implementation of a unique and powerful 
personal computer tool, the Online Text System (OTS). 

OTS is a personal system for entering, editing, and studying text. It 
differs radically from today's concepts of "editors" and "word 
processors" as explained below, and is optimized for the user who 
wants to use text in large quantities as a primary intellectual tool. 

As explained below under "History," the essential concepts presented 
here are not new. They have been implemented in a research prototype 
system and exhaustively tested in a work environment for several 
years by a team of up to twenty technical, clerical, management, and 
documentation people. 

There is reason to think that someone besides me is thinking about 
implementing these ideas on a personal computer. 



OTS IS NOT ANOTHER WORD PROCESSOR 

Most existing text processors fall into two categories: 

Editors: Direct or indirect descendants of hacks developed 
(often decades ago) by programmers who needed to edit source 
code . 

Word Processors: Elaborately integrated systems to be used by 
a clerical operator. These systems are intended for 
production of business documents from letters up to 
(occasionally) manuals. The function of formatting the text 
for hard-copy production Is the heart of these systems. Text 
entry is assumed to be done from some kind of draft provided 
to the operator by someone else. Documents are assumed to be 
small. Editing is assumed to be simple, and It is assumed 
that if you want to study a document you get a hard copy. 

The proposed OTS Is more like an editor than a word processor. In that 
It is to be operated personally by the creative worker. Also, It does 
not incorporate hard-copy formatting at all — this is done by any of a 
whole family of external processes with various specializations. All 
formatting done by OTS is screen formatting, and OTS is heavily 
optimized for this. 
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For example, while almost all editors and word processors are at least 
partly line-oriented, OTS is line-ignorant. It breaks statements into 
lines according to current display parameters, and does not store 
lines as such except when the user explicitly wants it to. 



CONCEPTS 



OTS Is designed with large, complex texts in mind. The problem in 
dealing with such texts on a screen is the difficulty of orienting 
oneself to the structure and content of the text. When you try to 
study, you get lost very quickly. Anyone who has tried this can 
understand the problem. It has never been addressed in a meaningful 
way by any production text system. 

OTS does address this problem. By letting, hard-copy formatting be an 
external function, OTS is able to have a study function as well as the 
traditional capture and modification functions of an editor. The same 
features that optimize OTS for studying the text also optimize it for 
ultra-efficient editing (since study is a key part of editing). 

Existing systems treat the computer as a tool for developing hard 
copy, under the assumption that hard copy is THE medium for text. 
Such systems are based on partial simulation of hard copy on the XRT. 
OTS treats the computer/CRT as a new medium for text in its own right. 



TEXT STRUCTURE 

The key idea of OTS is that a text has an Implicit structure which is 
known to the system. The structure used is the classic tree. Nodes in 
the tree are called "statements," and the content of a statement can 
be any string. Typically, an OTS statement is used to contain a 
paragraph, a heading, or a source-language statement. (Anyone who 
finds It hard to visualize a document as a tree structure need only 
think of the conventional "outline form" we learned in high school.) 

So every statement not only has a certain position within the sequence 
of statements, but it also has a "level" in the hierarchy of the tree. 
The system knows about levels. For example, when you create a new 
statement the system offers you a default level which is the level of 
the preceding statement. You can adjust the level down or up. 

For a first glimpse of the power this affords, imagine a huge text ~ 
equivalent to an entire corporate planning document, for example. Each 
chapter heading is a top-level statement; each section heading within a 
chapter is a second-level statement, and so forth. 

If you loaded up such a text in a conventional editor or word 
processor, you would then be in bad trouble if you wanted to find 
something that might be near the middle of the text. With tree 
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structure, you can command OTS to display only first-level and second- 
level statements. The second-level statements are displayed indented. 
Instant outline... Now you find the section you want, and move it to 
the top of the screen; at the same time, you specify "opening up" 
another level, with only the first line of each statement on the 
display. In this manner, you can very quickly find what you are 
looking for (in most cases). 

The tree structure is chosen because it is natural for both documents 
and computers. It is also an easy structure to understand. Writers 
who use it as an organizing principle soon learn to love it, and 
documents written this way are merely obeying the ancient high-school 
teaching: start by making an outline- It is not limiting, since the 
user is perfectly free to write all statements at the first level. 
This results in a "conventional" structure, i.e. linear. 

Using a system of this kind to develop and study the source code of a 
large program written in a block-structured language Is a revelation. 
Moreover, it turns out that if you use such a system as an editor for 
developing large source codes, it encourages structured programming. 



USE OF TEXT STRUCTURE IN EDITING 

The editing function falls into two parts: statement editing (the- 
familiar manipulation of strings, words, and characters) and structure 
editing. Structure editing is the manipulation of structural entities 
within the tree. For example, a "branch" is a subtree ~ a particular 
statement, all its substatements, all their subs tatements , etc. ^ou 
can delete branches, move then, copy them, etc. 

Other structure entities are defined: a "plex" is all the branches 
that are subtrees of a common parent; a "group" is a set of contiguous 
branches. 

The display normally shows structural relationships by Indenting 
statements accordirs to their level. Also, statements implicitly have 
numbers like 
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1 XXX 

la XXX 

2 XXX 

3 XXX 

3a XXX 

3a 1 XXX 

3a2 XXX 

3a 3 XXX 
3b XXX 
3c XXX 
A XXX 

The statement numbers are generated automatically and displayed on 
command. Of course, statement numbers change automatically whenever 
structure editing is done. 



USE OF TEXT STRUCTURE IN STUDYING 

The study function is supported by commands such as the J (ump set: 
[The prompt notation of UCSD Pascal is used here as an example, it 
should probably not be used in an Apple implementation of these ideas— 
Jef] 

J (ump 

S(uccessor: ntxt statement at same level 

P (redecessor : preceding statement at same ]evel 

U(p: parent statement 

D(own: first daughter statement 

0(rigin: root of tree, first statement in text 

L(ink: statement referenced in textual link 

N(ext: next statement in linear order 

E(nd: last statement in text 

R(eturn: statement jumped from to get current state 

A J(ump command operates by placing the specified statement at the top 
of the screen. The syntax also allows for the entry of various one- 
character codes called viewspecs. The viewspecs set the display 
control parameters for such things as the number of levels displayed, 
number of lines displayed per statement, whether statement numbers, 
labels, links, etc- are displayed, and so on. 

Another important viewspec enables or disables display filtering. 
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Display filtering is OTS's equivalent of the "string search" 
capabilities of a typical text editor. OTS offers the user a powerful 
"string specification language" (SSL) for specifying content 
characteristics of statements to be displayed; only statements with the 
specified type of content will be displayed when filtering is enabled. 

SSL is essentially an extended BNF. It contains a subset that is easy 
to use and approximates the customary string search function. For the 
more experienced user, a specification written in SSL can be stored as 
statement text and used by means of the command E(xecute S(tatement. 

SSL is itself a subset of a larger language which allows specification 
of primitive string-editing functions. This is String Search and 
Editing Language or SSEL. Users who are interested can also have all 
of SSEL, and can execute their own automatic editing sequences via 
E(xecute T(ext. 

This accesibility of detailed primitive functions via high-powered 
languages, and their integration into the text via E(xecute T(ext, is 
an important part of the design philosophy of OTS. Another step in the 
same direction is the 0(utput to C(ompiler command, which outputs a 
text of high-level source code (say Pascal) to a pre-compiler which 
converts it from OTS tree-structured file format to a compilable file. 
At this point OTS becomes reasonably serious as a software 
development /maintenance tool. 



ANOTHER KIND OF STRUCTURE 

Although the tree is about the most general and useful of the regular 
graph structures, it cannot do everything. Often it is desirable to 
have a linkage between two statements entirely independent of the tree 
structure. OTS allows you to establish such a linkage by giving a 
label to a statement and giving other statements links to that 
statement. The system knows about the meaning of links, and can 
"follow" them on command, displaying a statement according to a 
reference in another statement. 

Labels and links are part. of the content of a statement, but can be 
suppressed from the display on command. Notice that in high-level 
source code, labels and links can have the syntax of procedure names 
and procedure references. Also, a link can point outside of the 
current text. 

In summary, a text has an inherent tree structure and may also have a 
ueer-lmposcd arbitrary structure based on links. The link structure 
can point out of the text and into another text. The two structures 
are entirely independent of one another and both are actively supported 
by the user system. 
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HUMAN INTERFACE 

The success of any OTS implementation depends critically on the beauty 
of its human interface. The interface must feel extremely responsive. 
Speed of human input and speed of system response are both important. 

Human input is of two kinds: command mnemonics and cursor positioning. 

Cursor positioning is done by means of an analog device such as a 
joystick, forcestick, graphics pad. or mouse. Cursor control keys are 
absolutely not adequate, and it is critically important to make cursor 
positioning as easy as possible. (I suggest that all of these means of 
cursor positioning are relatively slow, see M19~Jef) 

It is desirable to have two control buttons available on the cursor- 
positioning device: one is used for a "command accept" function, and 
the other for "command delete." 

Most command mnemonics are single characters, and the command set is 
tree-structured. The flavor of OTS commands is best given by example; 
the D(elete commands are a good example: 

D (elete 
B (ranch 
P(lex 
G (roup 
S (tatement 
W(ord 
V(isible 
I (nvisible 
T(ext 

C(haracter 

These commands illustrate the general philosophy of OTS editing 
commands: one character (D) specifies a kind of action, and the next 
character specifies the kind of entity to be acted on. The entity 
W(ord, for example, means a string of al-phanumerics bounded at both 
ends by non-alphanumerics (or statement boundaries). After typing DW. 
the user positions the cursor to any character in the word and types a 
"command accept" character (which might be ctrl-C). The word is 
deleted; and OTS is smart enough to delete a space along with it, if 
the space delimits it. Alternately, instead of "command accept" the 
user may select another word; the meaning is to delete the two 
selected words and all between them. 

A V(iBible is simply any string of non-blank characters; an 1 (nvisible 
is any string of blank characters. T(ext is an arbitrary string 
defined by pointing to its first and last characters. 

In general, when OTS has a traditional function such as editing, it 
beats the competition by being smarter. For example, M(ovc and C(opy 
are distinct editing commands, and there is a T(ranspose command as 
well. The entity W(ord is handled correctly in all cases, as regards 
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Such 



punctuation and spacing after an editing command Is executed 
features are not frills; they are essential to the "hot" interface 
that any system like OTS must have If it is to succeed. 



NOTES TOWARD IMPLEMENTATION 

The file structure of an OTS text is something to think about. 
Ideally, there would he random access to statements; and ideally a 
text could extend over many diskettes. Hard disks are a natural thing 
to think about here. 

Speed of response is important ~ particularly the time required to 
reformat the screen. 



MARKET 

Who knows? My own position has always been that the potential market 
for this kind of tool is far, far greater than anyone has yet guessed 

at least if it is as cheap as it now can be. Many of the 

capabilities have to be used to be fully appreciated, and my guess is 
that to sell a full-dress OTS (or even half-dressed) would require 
some serious educational efforts. The implication is that if an OTS 
is worth doing, It's worth doing right. 



HISTORY 

At the 1967(?) Fall Joint Computer Conference in San Francisco, Dr. D. 
C. Englebart of SRI presented a system called NLS (for oN-Line 
System). NLS was presented as a tool of very wide scope for 
"augmenting the human intellect," but in Its specifics it was a system 
for editing and viewing text information. It offered the Individual 
text-oriented worker far more power than anything before or since. 

People who saw the FJCC presentation were overwhelmed — as much by 
the presentation as by Its content. Englebart sat on stage at a 
futuristic workstation custom-designed by Herman Miller, and operated 
the system in Menlo Park via microwave. The CRT image was projected 
on a theater-size screen behind him; TV Images of his face and of busy 
workers at the Menlo Park site were Intercut with the NLS display. It 
was a media triumph, but unfortunately one of the main impressions 
people got was that NLS was a monstrously expensive, extravagant, 
esoteric superwhizzle for use in a futuristic laboratory by the most 
rarefied geniuses. 1 think that many went away with their eyes 
bugging out, talked about It for a while, and then forgot. 

At that time. NLS ran on a timesharing XDS-940 dedicated entirely to 
serving NLS users. About half a dozen users could be served 
efficiently, up to about 20 with serious degradation of response. 
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Later, SRl's Augmentation Research Center operated NLS as a tool for 
the ARPA Network Information Center (NIC). This Incarnation of NLS 
ran on a PDP-10. Another incarnation was delivered to the Air 
Force. 

The engineering that went into NLS was extremely impressive. For 
example, a high-level machine-oriented language called MOL9A0 was 
developed for the XDS-9A0. It served as the mainstream language for 
developing NLS; but It was also used to develop a metacompiler which 
created compilers for a family of Special-Purpose Languages (SPL's). 
The SPL's included a string search and editing language, a tree 
manipulation language, etc. Some of the SPL's, or subsets of them, 
were directly available to the NLS user via NLS Itself. Eventually 
all the NLS software was contained in NLS structured files, cross- 
referenced to each other by the actual procedure calls in the source 
code and also by text links to the object code files. It was easily 
the most elegant large software system around. 

Hardware engineering was equally impressive; for example, the "mouse" 
device was invented In connection with this project. Some of the 
technical people on the project were Bill English, Jeff Rullfson, Bill 
Paxton, Chuck Irby , Don Andrews, Dave Hopper, Bill Duvall, Miml 
Church, and Bruce Parsley, many of whom later went to Xerox PARC. 

At the time of its development, NLS was strictly a demonstration of 
concept, as far as any public beyond the ARPA community was 
concerned. It was very expensive to use, its human interface 
depended on then-exotic hardware, timesharing systems were unreliable 
and inefficient. The concept of computer text processing was not 
thought to Involve anything better than justified margins on a 
Flexowriter. Eventually funding dried up, most of Englebart's 
technical people went to Xerox PARC where they were forever walled up 
in ivory, and NLS was forgotten — by most people. 

I was until 1969 the technical writer for the project, and have been 
carrying some of the Ideas around ever sinc^. I always thought it was 
a great pity that such a spectacular tool for writing and studying 
text was forgotten. It is now clear to me that future Apple systems 
are ideal for a modern descendant of NLS, optimized for an individual 
user. OTS is such a descendant, and I believe that if Apple does not 
eventually implement something like OTS, someone else will. 
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THE MACINTOSH PROJECT 
DOCUMENT 22 VERSION I 

TITLE: HOW CAN WE MAKE COMPUTERS TRULY PERSONAL? 



AUTHOR: JEF RASKIN 



DATE: 10 FEB 80 



What is curruncly considered "state-of-the-art" technology is beinc applied in 
many ways that affect our lives. While anything that affects our lives has 
an impact upon us as individuals, and is "personal" in that sense, 1 wish to 
distinguish one special set of application areas of technology froni the rest. 

This distinction is easily made by observing some existing technologies, each 
of which is over a century old: the telephone, hone central heating, and the 
office desL. Consider the desk first. In most circumstances it is assigned 
to a particular individual who will be the only person to use it — sometimes 
for many decades- Many sociological rituals and taboos surround the desk. 
Only the owner and a few other people, such as the owner's secretary or boss 
or other immediate "family" within the company feel at ease looking through 
it. In some instances there may be no other person who is authorized to go 
through your desk. In spite of this close attachment of the desk to an 
individual, it is rarely considered personal property. 

This example shows that an item, though closely connected with one individual, 
may not be personal in that it is neither owned nor controlled by the 
individual (the company may reassign the desk, say to move in a new one, 
without violating any taboos). It only affects the individual at work, and 
is rarely (if ever) thought of outside of one's place of employment. 

The example of central heating may be taken to stand for the welter of 
tangible property that we own (or rent) and that is associated with our homes. 
There is no doubt that this is all personal property, but none of it is 
essential personal technology in the sense being discussed here, even though • 
it affects our everyday lives and is often technologically based. I exclude 
these items because they are attached to the house and not to the person. 
When we move from place to place, we do not take the furnace and radiators or 
ductwork with us. While they may belong to us, they equally well belong to 
the home. Other items, such as a console television set, will move with us 
if we move, but they are primarily used at home. It is rare to find a 25 inch 
TV at the beach or in the office. Rather than personal technology, these 
items are appliances or fixtures. A small portable TV may be an instance of 
personal technology. 

The telephone instrument itself is attached either to home or to the working 
place (or is a public phone), and is thus not essential personal technology, 
but the telephone system is a different matter entirely. It affects every 
phase of our lives, in matters both personal and Involving our jobs. We 
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carry telephone numbers with u6, in books and in our heads and feel free to 
use them at almost any time. The telephone system, thouph not owned by any 
of iis, and not physically within our command, is an example of essential 
personal technology in the sense I am trying to develop. 

The general characteristics of an essential personal technology include its 
applicability to work, homelife and play; portability or wide geographic 
access or both; its importance or significance to the user in all these 
roles; af f ordabillty ; and options to make the technology aesthetically 
acceptable to the owner. 

If a technology does not Impact all phases of the user's life, that technology 
is not personal; if it Is limited as to where and when it can be used, a 
technology is not personal; if the user cannot purchase the technology or its 
use, it is not personal; if the user does not feel comfortable using the 
technology it is not personal; If it does not matter to the individual if the 
technology is always available or nearly so, it is not the kind of essential 
personal technology being discussed here. 

Calculators are an example of a technology that moved from non-personal to 
personal technology in the past decade. For many individuals it is used at 
work (say, to figure out sales tax), at hone (to balance the checkbook) and at 
play (to average bowling scores). The pocket calculator is independent of 
power lines. Is small and cheap, and comes in a wide range of styles to appeal 
to the consumer's illusion of making a significant choice. It became personal 
when microelectronics made it small and inexpensive. 

The same technology spawned the "personal" computer. However, in spite of 
their name, they are not yet truly personal. The so-called personal computers 
fail the tests proposed here on a number of grounds. Because computers, much 
more than most other technologies, have a wide and unpredictable range of 
application areas, the argument is more complex, but the basic factors are the 
same. 

The personal computer of today (such-as the Apple II on which I write this) 
fails nearly every test that I propose. I can use it at work, and do so every 
day. But then, 1 am a system designer, programmer and writer by trade. I do 
use It at home, but just to continue my working day at a different location. 
My calculator balances checkbooks nearly as well, and a lot more 
conveniently. I can force the computer into my avocations, but it is a square 
peg in a round hole. If the computer is used, as many have proposed, to 
control my house (e.g. adjust the heat, the windows and shades so as to take 
maximum advantage of solar heat and minimize thermal losses) then it becomes 
a fixed appliance and cannot be moved without disrupting the house. 

The present personal computer is neither truly portable nor widely available. 
Even though my computer is very light, rugged and small (about 5 Kilograms, 
and the size of a portable typewriter) and attaches to the ubiquitous 
television, by the time you bring along the mass of cables, the disk drives, 
and (heaven forbid) the printer, you need a wheeled cart or pet octopus to 
help you out. In addition, it must be plugged in before it can be used, so 
that it is difficult to use while travelling or even on a desk in the middle 
of a classroom — both places where the calculator is as handy as ever. 
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K, Apple is very slsrific.-t to .y Uf.. I q""! " th. prospect at ev.t 
technology. Only technocrats will find it as useful as I do. 

There is son>c question as to whether personal computers are affordable With 
I^e accessories required to ...e the. practical for a "^^J/^f 
cost 16 certainly over §2.000. This is too niuch by a factor of at 1^^^^^"°- 
TreaUstic sJstL. including sufficient quantities of .ass storage (which 
stores information and not mass!) and .cans for making this infonnation 
avaUable to the user (such as a screen or a printer) will cost much more than 
tha ^ ^ sysLm. to be practical just for the writing tasks I perform (such 
as ^Ms article) has a retail cost of about $7300. To be personal .t should 
cost under $1000. 

The system also fails the test of comfort of use and compatibility "IJ^ the 
dictates of personal style and interior decorating. While 1 could build (and 
manrh"e bu?U) a special enclosure to hide it all. the many separate pieces 
TZ\.::r interconnecting cables have a mad scientist air about them. An my 
computer happens to be one of the neater ones on the market--most ^re worse. 
The'computer comes in only one color, a neutral off-white ^8^^" J^J^ 
better than many others, but even the telephone company offers a choice of 
colors and styles for their electronically identical instruments. 

computers arc not comfortable to use P-allel^^comes t .^^^ 

Krientific calculator used a notation called Krw ^Reve^ae ruxx 
which thilerrSiy superior to the way most later calculators operate, does 
requirf few minutes of thought and practice. As a "^J'' -^^/J^f, 
percentage of calculators use RPN because it was not immediately com ortable. 
?imi!ari?, to get the full benefit from a computer, and to exploit its 
inherent flexibility the user must program it in some form (although ^ny 
benefits are available without programminc ) . 

Programming, as a human activity, rates with t^orture in the popularity polls. 
Is present? constituted programming requires study and P-ctice The low 
proportion of scholars and violinists in our population attests to the 
avoidance of study and practice by most people. 

It may be possible to provide programmabi 1 i ty in a convenient and painless 
form, but it has not yet been achieved. 

If a computer is not programmed by the user, then it must be -»P;°yf J^/ 

programs written by someone else. Whether such programs are comfortab e to 

ule depends on the sympathy and insight of the programmer or program 

At pJesent! programs'more commonly reflect the difficulties encountered in 

TrolrlZll Jhan the real needs of the user: like the spines of ^ 

Jhe awkwardness of most computer systems comes through in spite of many 

attempts to make the programs smooth and humane. 

The instructional books provided with programs (and with most so-called 
personal computers) all too often do not provide the cushion they m ght 
aglmst the stiff frames created by the programmers and system designers. 
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Thus present personal computers fail the test of comfort as well, and present 
owners must put themselves out in order to use them. 

The personal computer will come of age when it goes the way of the calculator 
or the telephone, or probably both. It will be small and portable, 
affordable, come in many styles, be easy to program when programmability is 
desirable, it will have features and software that make its use natural and 
convenient for an individual In the multiplicity of functions that -each 
Individual performs. In other words, it will become a nearly Indespensible 
companion like a Swiss Army Knife becomes to certain people, and its owner 
will feel a bit helpless when she or he leaves it behind. 
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THE MACINTOSH PROJECT 
DOCUMENT 23 VERSION 

TITLE: JANUARY 1980 OVERALL SUMMARY OF THE MACINTOSH SYSTEM 
AUTHOR: JEF RASKIN 

DATE: 12 Jan 60 



0- Concept 

The purpose of this design is to create a low-cost, portable computer so 
useful that its owner misses it when it's not around — even if its owner isn't 
a computer freak. [M2, MA, M6, M8, M13] 

The notations, such as [MO] refer to existing documents giving further 
details. 



1. Hardware 

Macintosh is intended to be a complete, self-contained, portable, personal 
computer. It does not have to be attached to anything other than a power 
source in order to operate. An optional battery pack will be available. 

Macintosh is designed to sell for about SIOOO [M5] , and will have a disk drive 
(with consideration of the possibility of a dual disk drive) and 7 inch CRT. 
A lightpen for graphic input is being considered and the computer may contain 
a small printer [MIS],. Macintosh will have a full alphanumeric keyboard, 
without separate numeric pad (an embedded pad will be used instead). If we 
have dual disks, they will share drive and head positioning motors. The size 
should be about 12 inches wide, 14 inches deep (maximum), and 6 1/2 inches 
high. The weight should be under 22 lbs. 

The electronics are conventional but streamlined: a 6809E processor, eight 
6AK RAMs (no expansion provided), 68A5 vidtio generator, a modem/DAA, ACIA, and 
supporting circuitry. We have not begun to approach the limits of what can be 
done with such an architecture. 

One central concept in the design of the hardware is that the programmers must 
have a fixed environment. This will help insure reliable user level programs — 
the emphasis in selling Macintosh will not fall on the hardware as much as the 
tasks that can be done with it. There must be no hidden "gotcha's" in the 
design (this program works only if you have a super-dupor board in slot 3, and 
have a jumper from pin 5 of IC 56 to your left pinky) IM6] 

The display is bit-mapped, black-and-white, 256 by 256 resolution with a 10 by 
10 cm (A. 5 inch) display area. A speaker and microphone will be built in, 
along with 8-bit D/A and A/D circuitry as necessary. Portability and cost 
constraints preclude color — in addition, the software should be compatible 
with future display technologies, which are likely to be monochromatic at 
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first. 

There will be a battery-supported real time clock. 

The computer may operate on 12 to 15 VDC, allowing operation from a wall 
transformer (minimizing thermal problems as well as simplifying UL approval), 
a battery pack, or from an automobile battery. 

2. Software 

At the user level there will be a combined text editor-data base manager, a 
calculator based language, and a disk oriented BASIC. 

The text editor is designed to be especially easy to learn and very fast to 
use. It is conceptually quite different than existing text editors, and a 
demonstration is being prepared. Tests have shown that many simple operations 
require one third to one tenth the time (for the operator) when compared to 
current Apple-based editors. The same mechanisms that allow the user to 
search through and modify text will be designed to allow searching and 
modifying a data base.(M19, M21] 

Text is displayed in a proportional font, allowing an averape of 72 characters 
per line; there will be at least 2A lines of text. 

The calculator based language is, again, extremely easy to learn. It is 
designed to sneak the user into programming, and yet provide powerful and 
Immediate commands without creating programs. It is at the same "level" as 
the text editor and will operate without system commands . [MIA, 

The BASIC should be an ANSI standard BASIC. It will be disk resident. 

At the system level will be Pascal and a -macro assembler. The operating 
system, invisible to the user, will be partly based on the concepts found in 
the Sara operating system. ^SOSl) 

3. Network ''^ 

Macintosh, however nifty its hardware and software, will not sell unless it 
does something useful. The number of useful things a personal computer can do 
with a network is vastly greater (probably by two orders of mrgnitude) than 
what it can do without a network. Thus the modcm/DAA is an essential part of 
Macintosh, and Apple must provide, at the very least, hooks into various 
information services. [M3, M12] 

A. Manufacturing and Service 

The electronics and software of Macintosh, as well as the physical packaf.inp ,. 
are being designed to allow economical manufacturing techniques and ease of 
repair. The electronics will be conceptually modular, for example timing will 
be done by one circuit instead of being distributed as it is on the Apple 11. 
The elimination of user options will streamline all aspects of the desip.n. 

5. Learning to use Macintosh 
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It is time to stop thinking exclusively in terms of writing manuals for 
computer systems. Manuals are just one means for accomplishing the real goal, 
which is to teach the user how to operate the software and hardware. For this 
teaching task, we must use whatever media arc most effective within our cost 
and time constraints: it is essential to the success of Macintosh that it 
have a level of educational accessories (whether CAl , cassettes or whatever) 
beyond even what present Apple products do. A major portion of the effort in 
producing software for this product may go into its self -teaching aspects. 



Personnel 



At present Woz is working part-time on Macintosh. The detailed electronic 
design and breadboarding is being done by Burrell Smith. A software designer- 
programmer will be hired. This team, along with myself and a support person, 
will design and produce prototypes of the electronics, first drafts of the 
language and hardware manuals and will write the major portion of the 
software. 

It Is expected that these A full-time people will be able to carry the project 
through the majority of the hardware and software design and execution stages. 
The BASIC interpreter or compiler, the industrial designing, the disk and 
printer hardware, the analog video and power supply design may require the 
aid of engineering people outside the project personnel. 

7. Accomplishments to date 

The proportional font has been demonstrated; the majority of the electronics 
has been designed and breadboarded ; preliminary specifications for the editor 
and a portion of the language have been prepared along with the outline and a 
few chapters of the user manuals. Much information pertaining to the software 
and hardware has been gathered, and many design choices (M2] have been made. 

8. Immediate tasks 

The following are some major tasks that should be completed in the next few 
months. 

A. A breadboarded version of the computer will be completed, this should be 
done by 20 Feb 80, unless there are excessive delays In obtaining parts 
(Smith). 

B. The editor portion of the software should be written to be demonstrated by 
15 March 80. This also entails a preliminary keyboard design. (Raskin) 

C. The UCSD Pascal system should be brought up on the breadboarded 
electronics by 1 April 80 (programmer to be hired). 

D. A support person should be assigned to the project. Aside from being the 
project librarian, this person will do some engineering and research tasks 
(e.g. Investigate current information services for small computer users). 

E. A decision is required from engineering as to what kind of disk drives we 
can expect for this project. We prefer a dual disk drive on a single spindle 
using something of the power of our present 16 sector technology. 
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THL MACINTOSH PROJECT 
DOCUMENT 2U VERSION 1 

TITLE: MACINTOSH FONT GENERATING PROGRAM 
AUTHOR: JEF RASKIN 
DATE: Dec 79 



INTRODUCTION 

With this program, on an Apple II screen, upper and lower case letters 

(an average of 78 characters per line of normal English text) can be displaye 

On the 256 by 256 Macintosh display there will be at least 23 lines of 

about 70 characters each, thus giving over 1600 characters on the screen. 

> 



(*$S+*) 

PROGRAM MAKEFONT; 
USES TURTLEGRAPHICS; 



CONST INTERSPACE" 1; 

TALL-IC; (* Height of characters. *) 

VERTSPACE" I ; (* Pixels between successive lines. *) 
LEFT - 12; 
RIGHT =267; 
BOTTOM " 0; 
TOP ■= 189; 

TYPE BYTE-0..255; 

BITMAP-PACKED ARRAY [0.. 9] OF BYTE; 

FONTPOINTER-^FONT; 

FONT-RECORD 

WIDTHS: ARRAY [0.. 127] OF INTEGER; 
CHARDATA: ARRAY [CI 27] OF BITMAP; 
END; 

VAR CURRENTFONT: FONTPOINTER; 

FUNCTION BINARY(S: STRING) : INTEGER; 

VAR I.NUM: INTEGER; 
BEGIN 
NUM:-0; 

FOR I: "LENGTH (S) DOWNTO I DO 
BEGIN 

NUM:-NUM*2; 

IF SIUo' ' THEN NUM:-NUM+1; 
END; 
BINARY :-NUM; 

END; 
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PROCEDURE MAKECHAR( ASCII, WIDTH: INTEGER; 

S9,S8,S7,S6,S5,S4,S3,S2.S1.S0: STRING) ; 



BEGIN 

WITH CURRENTFONT" DO 
BEGIN 

WIDTHS [ASCII] : -WIDTH; 

CHARDATA [ASCII, 9] -.-BINARY (S 9) 

CHARDATA [ASCII, 8] : =BINARY (S8) 

CHARDATA (ASCII, 7] : -BINARY (S 7 ) 

CHARDATA [ASCI I , 6] : -BINARY (S6 ) 

CHARDATA [ASCII, 5} : -BINARY (S5) 

CHARDATA [ASCI I , A] : -BINARY (S-!.) 

CHARDATA (ASCI I, 3] : -BINARY (S 3) 

CHARDATA (ASCI I, 2] : -BINARY (S 2) 

CHARDATA (ASCI I, 1 ]: -BINARY (S 1 ) 

CHARDATA [ASCI I, 0] : -BINARY (SO) 
END; 

END; 



PROCEDURE INIT3A; 
BEGIN 

MAKECHAR( 3,0,", 



1 



"); 

MAKECHAR( 8,0,", 



9 



/ 9 

1 



MAKECHAR( U,0,", 
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■'); 



MAKECHAR( 16,0,' 



"); 



MAKECHAR( 32.1, 



I 



' '); 

MAKECHAR( 33.1.'@', 

;r , 

'(»'. 

» 

"); 

MAK£CHAR( 34, 3, '6 , 



"); 

MAKECHAR( 35,5,' @ (?' , 
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f 

"): 

END; (* IN1T3A *) 

PROCEDURE IN1T3B; 
BEGIN 

MAKECHAR( 36,5,' (?' , 

'(3 0', 
' <?@', 

' . 

' @ @', 
'e @ @', 
' @@(?', 
' @'); 

MAKECHARC 37,A,'(?e @', 
(?', 
' (?', 
' @', 
' 

' @', 

"); 

MAKECHARC 3£,5,' 0', 

'(? e', 
"); 

MAKECHAR( 39,1,'(3', 



MAKECHAR( AO, 3,' 0' , 
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' Q'. 

t 

"); 

MAKECHAR{ Al,3,'(?', 
' @'. 
' @'. 

' r. 
' r, 
' 0', 
' 0', 

-0'. 
"): 

END; (* INIT3B *) 

PROCEDURE 1NIT4A; 
BEGIN 

MAKECHAR( A2,5,' @' , 

'C= (3 (3', 



); 



MAKECHAR( 43,3,", 



"): 

KAKECHARC A4,2,", 



I 



'0', 
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PROCEDURE IN1T4B; 
BEGIN 

MAK£CHAR( 45,3,", 



"); 

MAKECHAR( 46,1,", 



"): 

MAK£CHAR( 47,4,' ^' , 

' r , 
' (?'. 

' <?'. 

' e'. 

» 

"): 

MAKECHAR( 4b, 4, ' @@' , 
'Cd(3 @-. 

@' . 
'e @', 
' @@', 

» 

"); 

MAKECHAR( 49,4,' @' , 

' ec^', 
' r. 
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' r. 
' 

' e', 

' @'. 

"); 

END; (* INITAB *) 

PROCEDURE IN1T5A; 
BEGIN 

MAKECHAR( 50. A,' , 



* 

"); 

MAKECHAR( 51,4,' 6?', 
' <?'. 

' e'. 
' 

» 

"); 

MAKECHAR( 52,4,' (?' , 
' eG' , 

'@ 

' 

* 

"): . 

MAKECHAR( 53. A , ' e^Gig' , 



> 
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MAKECHAR( 54, A,' , 

'(3 r , 



'); 



END; (* 1N1T5A *) 



PROCEDURE IN1T5B; 
BEGIN 

MAKECHAR( 55. A, , 

' r , 

• (?', 

' e'. 

' r , 
• 

' (?', 
"); 

MAKECHARC 56, A,' ^g', 

'@ e' . 
"); 

MAKECHAR( 57, A.' 

'@ (?', 
'(? @', 

' m' , 

' @'. 

' (?' ; 

' (?', 



); 



MAKECHARC 58.1, 



M2A.1 Page 8 

'■RaskinDoc003 1 1 31 PICT" 58 KB 2000-02-27 dpi: 300h x 300v pix: 2050h x 2959v 



Source: David T. Craig 



Page 0133 of 0174 



Jef Raskin Document # 003 -- Macintosh Project Memos (February 1980) 



The fk Macintosh Project: Selected Papers (14 Feb 1980) 



of 171 



'■); 

MAKECHAR( 59,2,", 



'I?'. 



END; (* 1N1T5B *) 



PROCEDURE IN1T6A; 
BEGIN 

MAKECHAR( 60, A,", 

' @', 

' (?'. 
' @', 
' (?', 

"); 

MAKECHAR( 61,3,", 



t 
» 

"); 



MAKECHAR( 62,A,", 

• 

' @'. 
' @'. 
' @'. 
' @'. 

f 

"): 

MAKECHAR( 63,4,' , 
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ID 



"); 

MAK£CHAR( 6A,5,", 

'@ (?' , 

'@ (a @', 
"); 

MAK£CHAR( 65,4,' gG' , 
'@ (?', 
'(? (?', 

'@ 

'@ (?'. 



END; (* 1N1T6A *) 



"); 



PROCEDURE IN1T6B; 
BEGIN 

MAKECHAR( 66,4,'0(3@', 
'@ @'. 

'(? @' , 
'@ <?' , 
'(? 

"); 

MAKECHAR( 67, A,' 00', 
'@ @', 
'0'. 
'@'. 
'<?'. 

'@ @', 
' @0'. 
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"); 

MAK£CHAR( 68,A,'@@@', 
'Q Q' , 
'@ Q' , 
'& Q' , 
'@ Q' . 
'@ Q', 
Q', 

f 

"); 

MAKECHARC 6i< , 4 , ' @(a@(?' , 
'(?'. 
'(?', 



"); 

MAKECHAR( 70, A. '|3(?C»C^' , 



"); 



END; (* IN1T6B *) 



PROCEDURE INIT7A; 
BEGIN 

MAKECHAR( 71, A,' (3@' , 
'@ Q', 



); 



MAKECHAR( 72, A, '@ , 
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'Q (3' . 



"); 

MAKECHAR( 73 , 3, ' ' , 

' r, 
' @'. 
' r, 
' @'. 
' (?', 
. ' e'. 

» 

"); 

MAKECHAR( 7^,4,' <?' , 
' 

' r , 
"); 

MAK£CHAR( 75, 5, 'C @' . 

'@ 0', 
'(? Q', 
'(3(3'. 
'(3 @', 
'@ @', 
'@ @'. 



"); 

END; (* 1NIT7A *) 

PROCEDURE 1NIT7B; 
BEGIN 

MAKECHAR( 76, A, '@', 
'(?'. 



'@', 
'(?', 

"); 
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MAKECHAR( 77, 7. '@ Q' , 

'(3(3 0(3', 

'(30 Q@- , 

'(3 (3 @ (3', 

'@ @ @ (?' , 
'@ Q r. 



MAKECHAR( 78,5,'(a @' , 
'(3(3 @', 
'@@ @', 

'@ m', 
"); 

MAKECHAR( 79, A,' (?(?', 

'@ r. 

'@ @'. 
'@ @', 
'(? (?'. 
' (?(?', 

"); 



MAK£CHAR( 80,A,'@e(?', 

"); - 

END; (* 1N1T7B *) 

PROCEDURE 1N1T8A; 
BEGIN 

MAK£CHAR( 81,5,' @(3' , 

, 

'(3 Q' , 
'@ @'. 
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'0 @'. 
r, 

"); 

MAKLCHAR( 82 , A , ' (3@(3' , 
'Q 0', 

'0 I?', 



"); 

MAKECHAR{ 83,4,' QQ' , 

' r. 



"); 

MAXECHAR( 8A,3,'(3@e', 

' r, 

' (?', 

' 0', 

' (?'. 
' 

' @'. 

' 0'. 

> 

MAKECHAR( 85,A,'(a @' , 
(?' . 

0'.- 



); 



END; (* INlIfcA *) 



PROCEDURE 1NIT8B; 
BEGIN 

MAK£CHAR( 86,5,'(a @' , 

'e 0' . 
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'0 @', 
'(? r , 
' e @', 
' @ @'. 
' @', 
' r , 

MAKECHAR( 87. 7, '0 @' , 

'@ @ @', 
'e e @', 
'@ e (?', 

"); 

MAKECHAR( 88,5,'(3 g' , 

@', 

@', 

' @ (?', 



"); 

MAK£CHAR( 89, 5, 'g I?', 

' @ @'. 
' 0'. 
' @', 



« 



); 



MAKECHAR( 90, A , '@@@@' ,- 



END; (* 1N1T8B *) 



): 
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PROCEDURE IN1T9A; 
BEGIN 

MAKECHAR( 91,3,'@@(a', 

'r. 



"): 

MAKECHAR( 92, A, '0', 

' r, 
' @'. 
' 

' (?', 

t 

"): 

MAXECHARC 93,3,'@@@', 

' r , 

' @'. 

' r , 
• @'. 

"); 

MAKECHAR( 9A,5,' @', 
' @ @', 



); 



END; (* 1N1T9A *) 



PROCEDURE 1NIT9B; 
BEGIN 

MAKECHAR( 95, A,", 
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"); 

MAXECHAR( 96, 2, 

'0', 
' Q', 



"); 

MAKECHARC 97,3,", 



'(3(a@' , 



* 



); 



MAKECHAR( 98, 3, 

f 

:'); 



MAK£CHAR( 99,3,", 







END; (* 1N1T9B *) 



): 



PROCEDURE INITIOA; 
BEGIN 

MAKECHAR(100.3.' @' , 
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' Q' ; 
' Q- . 

'Q Q'. 

(?', 
'Q Q' . 

-@(3(3', 

1 

' * \ . 






MAKECHARdOl, 3, " , 
• 








, 

'13', 






MAKECHAR(102,3,' @@' , 

'(?', 
"): 






MAK£CHAR(103,3,", 

» 








e', 
@', 
r , 

'nr , 

• 

'@@C»'); 






MAKECHAR(10A,3,'e' , 

'0 r. 






f 

"); 

END; (* INITIOA *) 
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PROCEDURE IN IT 1 OB; 
BEGIN 

MAKECHAR(105. 1,", 
'(3', 



"); 

MAK£CHAR(106,2,", 

' r, 

' 
' 

' e', 
' (?'. 

MAKECHAR(107,A,'@' , 
'0', 

'e 0', 

> 

"); 

MAKECHAR(108,1,'(5', 

'(?'. 
'(?'. 

"); 

MAKECHAR(109.5,", 



M2A.1 Page 19 

'■RaskinDoc003 1 1 42.PICT" 54 KB 2000-02-27 dpi: 300h x 300v pix: 2044h x 2970v 



Source: David T. Craig 



Page 0144 of 0174 



Jef Raskin Document # 003 -- Macintosh Project Memos (February 1980) 



^ The il Macintosh Project: Selected Papers (14 Feb 1980) of 171 



END; (* INITIOB *) 



PROCEDURE INlTllA; 
BEGIN 

MA1CECHAR(110,3," 



'0(3(3-, 
'@ Q' . 

'@ r. 
'@ (?', 

"); 



MAXECHAR(111,3.' 



'@ (3', 
'@ @'. 
'(? @', 
'@(3(3', 

t 

"): 



MAKECHAR(112,3,", 



MAKECHAR(113,3, 



MAK£CHAR(11A,3,' 
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'(? r, 

'Q'. 

'(?'. 

» 

END; (* INITllA *) 

PROCEDURE INITllB; 
BEGIN 

MAKECHAR(115,3.", 



'@|3(3', 

' r, 

» 

"); 

MAKECHAR(116,2,'@', 



"): 

MAKECHAR(117,3,", 



); 



MAKECHAR(116,3,", 
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"): 

MAKECHAR(1I9,5.", 



Q Q'. 

Q r. 
; e r, 
"); 

END; (* INITllB *) 



PROCEDURE IN1T12A; 
BEGIN 

MAKECHAR(120,3,", 



1 



'@ @', 

' r, 

y. ^'^ 

"); 

MA1CECHAR(121,3,", 

'@ r , 
'@ @', 
'@ @', 

' 

'@@@'); 
MAKECHAR(122,3,", 

f 

, 

' 0'. 

"); 

MAKECHAR(123.3.' 0', 
' 
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'e'. 
' r, 

' 0'. 
' 0', 
' 0'. 

"); 

MAKECHAR(12A, , 



"); 

END; (* 1NIT12A *) 

PROCEDURE INIT12B; 
BEGIN 

MAK£CHAR{125,3,'(?', 
' @', 
' @'. 

' r, 
• r, 
' e', 
' @', 

"); 



MAKECHAR(126.5, ' 



1 





1 



END; (* 1NIT12B *) 



PROCEDURE 
BEGIN 

INIT3A; 

1N1T4A; 

1NIT5A; 

1N1T6A; 

INIT7A; 

INIT8A; 

INIT9A; 

INITIOA 



INITCHARS; 

1NIT3B; 
INIT4B; 
1N1T5B; 
1NIT6B; 
INIT7B; 
1NIT8B; 
INIT9B; 
; INITIOB; 
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INITllA; INITllB; 
IN1T12A; 1N1T12B; 
END; 

PROCEDURE NEWLINE; 
BEGIN 

MOVETO(LEFT,TlIRTLEY-(TALL+VERTSPACE) ) ; 
END; 

PRCX:EDURE WCHAR2(CH: CHAR); 
BEGIN 

DRAWBL0CK(CURRENTF0NT".CHARDATA[0RD(CH)] ,1,0,0, 

CURRENTFONT-^ . WIDTHS (ORD (CH ) J +INTERSPACE , TALL , TURTLEX , TURTLEY , 5 ) ; 
IF TURTLEX < (RIGHT - 8) 

THEN MOVETO (TURTLEX+CURRENTFONT'" . WIDTHS (ORD (CH ) ] +INTERSPACE , TURTLEY ) 

ELSE NEWLINE; 

END; 



prcx:edure home; 

BEGIN 

MOVETO (LEFT, TOP- (TALL+VERTSPACE) ) ; 
END; 

PROCEDURE POKE (LOC, VALUE: INTEGER) ; 

TYPE WINDOW - PACKED ARRAY {0. . 0] OF CHAR; 

VAR ADDR: INTEGER; 

P: -WINDOW; 

BEGIN 

ADDR :- LOC; 

MOVELEFT (ADDR, P, 2); 

p-[0] CHR(VALUE); 
END; {*POK£*) 

PROCEDURE SEND{CH: CHAR); 
BEGIN 

UNITWRITE (6,CH, 1,0, 12) ; 
END; 

PROCEDURE UNIDIRECriONAL; 
CONST MAXBYTE - 255; 

DIRECTION - -12529; 
BEGIN ■ • 

POKE (DIRECTION. MAXBYTE) 
END; (* UNIDIRECTIONAL *) 



PROCEDURE PRINTPIC; 
CONST CQ ■= 17; 
BEGIN 

UNIDIRECTIONAL; 

SEND (CHR (CQ));(* DISPLAY THE PICTURE *) 
END; 
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PROCLDURE INTENSITY (DARK: INTEGER) ; 

CONST INTEN - -12528; 

BEGIN 

IF DARK < THEN DARK : •= 0; 
IF DARK > 7 THEN DARK 7; 
POKE (INTEN, DARK); 
END; 

PROCEDURE ECHO; 
VAR I: INTEGER; 

CH:CHAR; 
BEGIN 

INITTURTLE; 
FILLSCREEN (REVERSE); 
HOME ; 
REPEAT 

READ ( KEYBOARD, CH ) ; 
IF EOLN (KEYBOARD) 
THEN 
BEGIN 

NEWLINE; 
WRITELN; 
END 
ELSE 
BEGIN 

WCHAR2(CH); 
WRITE (OUTPUT, CH); 
END; 

CASE ORD(CH) OF 

8: M0VET0(TURTLEX-2,TURTLEY); (* graphic backspace ) 

lA: FILLSCREEN (REVERSE); 

16: HOME; , nr.. 

102: MOVETO(TURTLEX-l.TURTLEY); (* ligature on lover case t ; 

END (* OF CASES *) 
UNTIL 0RD(CH)=3; 
intensity (6); 
printpic; 
TEXTMODE ; 
END; 



BEGIN (* MAIN PROGRAM 
NEW(CURRENTFONT) ; 
INITCHARS; 

SrI™' ('START TYPING. CTRL-C TO QUIT. CTRL-N FOR BLACK-ON-WHITE. ' ) ; 
IflT^ i cTr-P H^ES. CTRL-H (LEFT ARROW) BACKSPACES GRAPHICALLY. ); 

ECHO ; 
WRITELN • 

WRITELN ('TEST COMPLETE'); 
END. 
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THE MACINTOSH PROJECT 

docuiie:;t 25 version i 

TITLE: THE COMPLETELY rUSTRIBIITED C0M:;UNICATI0N"S NETU'DRK 
ADTHOR: JEF PJi^SKIH 
DATE:l| FEB 1980 

0. IUTRODUCTION 

Previous Macintosh documents have made a case for the es tablishnent of a 
communications network as being essential to the large- scale sales of 
personal computers. This realization is not unique to Apple, of course, but 
is being increasingly recognized by many segments of the computing 
community. The most Important question is: How can Apple establish 
communications networks for our customers in a timely and economical fashion? 

1. WHAT IS A COMMUNICATIONS NETWORK? 

A' communications network consists of addressors who generate messages and 
addressees for whom the messages are intended; and a set of potential pathways 
that join all possible pairs of addressors and addressees. Addressors and 
addressees are usually people. Each person in the network has both a sender 
and a receiver which are devices that effect the generation, transmission and 
delivery of messages. 

An addresser generates a message, transmits it over a pathway by means of the 
sender; an addresee receives the message on the receiver. This formalism 
describes, for example, the familiar telephone communication network. The 
usual television and radio "networks" are not communications networks in the 
sense being discussed here since they are unidirectional. 

We must distinguish, in our communications network, between the sending of a 
message, its transmission, and its reception. A message is sent_when the 
addresser consigns it to the network. The network may have to store the 
message until a transmission pathway becomes available. Thus the time at 
which a message is sent may not be the same as when it is transmitted. In any 
case, the two actions ire distinguishable. (We can further distinguish 
between the time a message is generated , and the time it is sent.) 
/ 

Likewise, at the receiving end, the receiver or addressee might not be 
available. Thus the network (or the receiver) may have to store it. The 
time at which a message is transmitted may not be the same as when it is 
received. And the time at which it is acquired by the receiver may not be the 
same as the time when it is (finally) read by the addressee. Again, in any 
car",, the actions of reception and reading differ. 

These distinctions -.re, of course, not necessary with the usual use of the 
telephone network, which may be described as a "real time" network. One of 
the benefits of a non-real-time network is Immediately apparent to anyone who 
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has had to work across time zones — or who wishes to speak to someone on a 
radically different schedule. 

In summary, then, the actions are: 

Generation — > Sending — > Transmission — > Reception — > Reading 
The corresponding actors are: 

Addresser Sender Pathway Receiver Addressee 

1.1 THE ABILITIES OF A NETWORK 

The personal computer network must have these abilities: 

a. An addresser may, at any time, generate and, at that or any later time 
send a message. 

b. An addresser may inquire as to whether a message has been read by the 
addressee, and possibly inquire as to the exact state of the message (sent or 
not, in transmission, received or not, read or not). 

c. An addressee may inquire as to the presence of received messages for him 
or her, and read any or all of them at will. 

2. WHY WE MUST HAVE PERSONAL COMPUTER NETWORKS 

It is pretty clear from the amount of activity going on in the field that this 
is a "hot" area. The reason that it is so popular is that there is not much 
most individuals can do with a single, isolated computer. Yet, with access to 
a number of data bases and message sending and receiving ability, it is 
possible to see many uses of personal computers that are neither esoteric nor 
difficult. A previous Macintosh paper discusses this issue. 

3. THE COMPLETELY DISTRIBUTED NETWORK 

The ordinary telephone network is not distributed at all (from the point of 
view of the user). Each telephone has only the ability to passively receive 
a message, or to initiate the sending of one. What intelligence the system 
has, and its control, resides elsewhere. 

It is useful to define a node as a place on the network where one or more of 
message generation, sending, reception, and reading may take place. A node 
ma^, as a consequence, perform a switching function — i.e. receiving a message 
and then sending it on one or more pathways for whatever reason. 

A terminal node has exactly one bi-directional path leading to it. 

A distributed system Is one where each terminal node has some control, but 
where there are non-terminal nodes which can control the flow of information 
about the network. These non-terminal nodes may also generate, -itore, monitor 
or act on messages. 

In a completely distributed network, all intelligence and control resides 
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at terminal nodes. 

Tn the conoletely distributed network being considered here, the terminal 
^odes are perSonll computers, and the pathways are ordinary telephone Unes. 

4. HOV; THIS COMPLETELY DISTRIBUTED NETWORK OPERATES 

The terminal node for each person is a computer. When ^ . 

message his or her computer stores it. The message contains the address of 
thraddressee. which in this case is probably the addressee s telephone 
number. The c;mputer (as soon as it can) attempts to dial the addressee s 
nhone It can recognize whether or not the phone is answered by the 
phone.. It can r g properly answered. It tries again after a 

ferrairLIa^T; 'are r as^L for'Sing^he delay a constant plus a random 
time ?twil continue making these attempts until the message s received 
lirI;knowledged-or until the message is deleted from the Ixst of messages 
waiting to be sent by the addresser. 

before It transmits messages. 

At the receiving end, the computer, 'when an incoming call arrives, determines 
tie her it is a computer call or a human call. If it is a human =^11 it 
allows tie telephone bell to ring, and ignores the --^\''^-'f'''^'-JJj' 
allows tne p stores the message, and sends out the acknowledgement 

Lrs^g: If 'has berinstructed L'do so. it will display the message as 
it arrives, if not, it will store it until the addressee wishes to see xt. 

4.1 SOME PROBLEMS WITH A COMPLETELY DISTRIBUTED NETWORK 

If a message is sent, but the receiving computer is -"^^f Tec'^er 

the receiving end may answer the phone and discover a tone. If the receiver 
is avanable! there should be enough time allowed to plug it m, but if not, 
tSe call will be wasted. This is a definite problem with a completely 
distributed network given current phone tariffs and technology. 

A broadside (a message to many addressees) can be sent by h.vi,ng a file of 
many telephone numbers, all of which are sent the same message. But it is 
the area of dealing with classes of users that the completely distributed 

V tern ?s weakest compared to a partially distributed ' -^f,;; 

a nerson wanted to correspond with all others interested m. say. butterfly 
roUectinr it would be relatively easy for a central computer to put ou such 
a iotice-'knce it would have the addresses of all users. In a completely 
distributed system It would take many fruitless calls to try to find these 
users. 

On the other hand, the completely distributed network assures a great degree 
of privacy to the Individuals involved. 

message nav t 'orwarded by merely indicating to the addressee that it Is to 
be forward^: 1 suspect that anv automatic forwarding scheme will unduly 
raise the hackles of the phone company. 
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5. SECURITY 

c ,rltv is not a responsibility of the network, but of the individual users 
" I r!o"v 1 users of the network must assume that transmissions 

Sre pub^rc l^er'efir: a ufer wishing to make a secure communication must 
tIke'respo;siMlity fo; encryption and subsequent decoding by the addressee. 

This shifts the burden of privacy away from the network itself. It might be 
observed that security software is a salable commodity. 

6. LEGAL ANn REGULATORY PROBLEMS 

The use of computers over the telephone network poses a number of Problems for 
X. telephone company. As discussed in a earlier Macintosh document the 
useape statistics are skewed when computers talk to eachother. In addition 
sole time-slice methods now in use for compressing many conversations into a 

"^leTroadband channel may play havoc with schemes 
"ansmisslon speeds (in excess of 300 baud) between terminal nodes- There ma> 
even be difficulty at 300 baud. 

Aside from anv genuine difficulties that a computer ^"'"'J""? -f 'T^heir 
cluse the tel'ephone svstem. we must be concerned with the P^^^^^^'^ f 
attempring to derive added revenues whenever digital communications are used. 
This, too, was discussed In document M3, to which you are referred. 

There are pathways other than the telephone system, but they may not be in 
place quickly enough for our present needs. 

7. DATA EASES 

A data base may be considered a "person" who is the -<^^"-" J" 
information, and who responds by sending messages consisting of ^l^e desired 
information. No new network protocol is required-but the fori, of messages 
received by the data base will have to be carefully contrived. 

Comoanifes that provide data bases may also provide message services. The use 
of baJefls discussed in M3. which includes a list of applications as 

well as possible vendors. . 



8. THE REQUIRED INFORMATION EACH MESSAGE CONTAINS 



A protocol will have to be established so that me 
information to keep the network in operation. For example 

a. Date and time sent. 



ssages contain sufficient 



b. Addressor 

c. Addressee (which may be a class) 

d. items a, b and c of the message being responded to (if any). 
The questions of protocols, both electronic as well as 

widely discussed. A* planned (but not yet promised) Macintosh document may 
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cover this in greater detail. In the meantime, a model based on the PCKET (P. 
0. Box E, Menlo Park, CA 9^025) protocols or the Arpanet heading conventions 
may be kept in raind (See The Network Nation by Hiltz and Tiiroff). 
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THE MACINTOSH PROJECT 
DOCUMENT VERSION 7 

TITLE: CATALOG TO MACINTOSH DOCUMENTS 
AUTHOR: JEF RASKIN 



DATE: 



28 Sep-12 Oct 79 



M 0. 7 CATALOG 

A numerical, annotated, listing of all M;-:ntcsh documents. 

M l.A INTRODUCTION AND PRELmiNARY CONVENTIONS 

The conventions for documents, their distribution a'.ti cataloging. 

M 2.8 OVERVIEW OF PRELIMINARY AREAS OF CONCERN 

A list, slightly annotated, of the various ques'tions . lat must be 
answered in designing Macintosh. It is rather comprer^ensive. 

M 3.5 THE APPLE COMPUTER NETWORK 

Justification of and preliminary thoughts on a network. 

M 4.1 THOUGHTS ON ANNIE 

An old memo, from May '79, with some early thoughts on what was 
to become the Macintosh project. Eccentric use of English. 

M 5.1 PRELIMINARY COST INVESTIGATION 

A brief rundown on the cost of the major electonic and mechanical 
components of Macintosh. The $500 selling price is shown to be 
a difficult mark to reach. 

M 6.2 GENERAL CRITERIA 

An expansion of the general criteria listed in M 2.8, defining the 
major goals of the project. 

M 7.7 A MODEL OF MEMORY VS DISK CHOICES 

A description of the design of a mathematical nxDdel. 

M 8.1 PERSONAL AIMS 

My aims in doing the Macintosh project. 

M 9.6 PASCAL MODEL OF MEMORY VS DISK CHOICES 

A non-interactive program that sweeps through v^...:ious 
document and memory sizes. Largely superceded by M 10. 

M 10.3 INTERACTIVE PASCAL MODEL OF MEMORY VS DISK CHOICES 

An interactive model that allows you to easily vary parameters. 

M 11.0 SUMMARY OF OCTOBER 10 

A few of the main points of the project as of October 10 

M 12.1 CONCERNS ABOUT USING THE TELEPHONE WITH PERSONAL COMPUTERS 
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An article written for magazine publications on the probable 
difficulties we might encounter working with Ma Bell. 

M 13.1 IMPORTANT POINTS ABOUT MACINTOSH 

A one page summary of the summary of October 10, prepared 
for the meeting of 12 October. 
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THE MACINTOSH PROJECT 
DOCUMENT 1 VERSION A 

TITLE: INTRODUCTION AND PRELIMINARY CONVENTIONS 
AUTHOR: JEF RASKIN 



2nel Coy^ _ 



DATE: 11 Sep 79 

1. CHANGE OF NAME 

To avoid using only female names on projects, it b.&s been suggested that each 
major project be assigned the name of a variety of apple. To begin with, 
what once was the "Annie" project is now called the "Macintcsh" project. 

2. CATALOGING TECHNIQUE FOR MACINTOSH DOCUMENTS 

As each document pertaining to Macintosh is written, it will be given a 
serial number. A catalog will be kept on a diskette In my files. I 
therefore request that any document pertinent to the Macintosh project not be 
released until it has been cataloged. This will permit any interested party 
to know what documents have been written, and will allow us to obtain and 
use these documents when necessary. The catalog will also be available in 
printed form upon request. 

3. INTERNAL DESIGN OF DOCUMENTS 

It would be appreciated if each item in each document be numbered, so that we 
may easily refer to it in other documents, for example: 

Document 4, Version 3, Item 6. A. 

The heading for each major numbered section will be in all caps, with 
subsections having the first letter of the first word capitalized. 

4. USE OF EDITOR FOR DOCUMENTS 

For improved communication, documents should, whenever possible, be prepared 
on the Pascal Editor, with appropriate control characters for Colin's 
formatting program. A typical heading for each document might be: 

.fo ' 'Ml. 4 Page % 

DOCUMENT *** VERSION *** 

THE MACINTOSH PROJECT 

TITLE: *** 

AUTHOR: *** 

DATE: *** 
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This will facilitate building a library of Macintosh documents, and easily 
allow modification and updating of these documents. 

5. The file name of each document shall be of the form Mx.y.text where x is 
the document number and y is the version number. The catalog is MC.x.text. 

6. The responsibility for maintaining the catalog shall initially be Jef's, 
but may be assigned to another member of the Macintosh team when appropriate. 

7. Distribution lists and dates by which comments must be received shall be 
part of the cover letter, and not part of the document. 
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THE -MACINTOSH PROJECT 



DOCUhtEMT 2 VERSION 8 



TITLE: OVERVIEI'? OF PRELIMINARY AREAS OF CONCERN 



AUTHOR: JEF RASKIN 



DATE: 



11 Sep 79 



. MARKETING AND AUDIENCE 

1 . 1 Markets 

1.1.1 Home 

1.1.2 Business 

1.1.3 Scientific 

1.1.4 Industrial 

1.1.5 International 

1.1.6 Educational 

1.1.7 Hobby 

1.2 Contributions this product will make 

1.2.1 This may be the first (unless something else comes along)T=ei»e 
ti -vo t portable computer. If this point of view is adopted, then 
applications, such as home security, where the computer is tied 
to a physical location, can be eliminated. 

1.2.2 I would like this to be a completely self-teaching system. 

1.2.3 Price/Performance breakthrough. 

1.3 Overall strategy 

1.3.1 vis a vis competitors 

1.3.2 vis a vis other Apple products 

1.3.3 in view of unprecedented large numbers 

1.4 Sales goals 

1.4.1 Number of machines over time 

1.4.2 Dollar figures 

1.5 Major risks ^'^ 



1.7 General criteria 

1.7.1 Reliability/<works correctly) 

1.7.2 ServiceablZtlty (long MTBF) 

1.7.3 Produce ability (designed for the production line) 

1.7.4 iTrlceyR grf orman ce^ high 

1.7.5 External esthetics excellent (as is our custom) 

1.7.6 Integrity (sufficient testing of all components incl. manuals) 

1.7.7 Maintainability (short time to repair) 

Possibility of self -diagnostic programs; possibility of diagnostic 
through network. 

1.7.8 Documentable (easy to write manuals due to good design, esp. of 
software) 

1.7.9 Expandable (hardware should not limit range of applications 
unnecessarily) 

1.7.10 Learnability (co-ordinated hardware/software/manual design with 
this constraint In mind at all times) 

1.7.11 Testability (must be testable automatically at the plant) 

1.8 Product life 

1.9 Profit goals 
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2. MAJOR CONSTRAINTS 

2.1 Price constraints 

The initial end-user price, for the minimal machine, should be about 
$500. It is our intent to have a clear path to lowering the price to 
$300 after 18 months, while maintaining profit margins. 

2.2 Weight and size constraints 

2.3 Memory size 

We nay wish to fix memory size (and eliminate many possible user hardware 
options) so that software runs on all Macintoshes. Users should not have 
to know about how many bytes of memory they have. This may also allow us 
to produce the machine for less. A user mlnlirium of 32K bytes is suggested. 
This will depend on mass storage considerations as well. 

3. POSTER SUPPLY <ffr^st^._/ ' - - / ''^ 

3.1 AC supply from the mains 

3.1.1 US 

3.1.2 Foreign 

3.2 Battery supply 

3.2.1 Weight 

3.2.2 Reliability 

3.2.3 Operating time 

It would be nice to obtain 6 hours without having to plug it in. What is 
a minimum that is still useful? 

3.2.4 Potential leakage problems 

3.2.5 Primary or Secondary cells? 

3.3 Solar cells 

To keep perpetual ca^lendar independent of other power supplies? 

4. HUMAN INTERFACE: DISPLAY 

The screen should be soft if possible. Image data compression should be 
considered to conserve memory. 

4.1 CRTs 

4.1.1 Home TV 

We should have RS-170 and NTSC compatible output. It should work into 
any standard TV equipment, such as recorders. Both video and modulated 
outputs should be available. If cost constrains, the video would go. 

4.1.2 Built-in display 

There is the possibility of no built-in display and only a built-in 
printer. The hard-copy device, on the other hand, raay be part of 
the display. 

4.1.2.1 Conventional CRT 

4.1.2.2 Flat CRT 

4.1.2.3 Projection CRT 

This option has much flexibility, especially in conjunction with a 
photographic hard copy scheme. - - : ' 

4.2 LCD display . 

4.3 LED display 

4.4 Plasma display 

4.5 Other technology (e.g. laser) 

4.6 Size of screen 

4.6.1 Number of characters 
4.f^.2 Graphic resolution 
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4.6.3 Physical size 
A. 7 Color 



5. MASS STORAGE 

Some form of mass storage must be built in. 

5.1 Floppies 

5.1.1 Made by us 

5.1.2 From outside vendors 

5.1.3 Very small floppies (2 or 3 inch) 

5.1.4 Compatible with any previous product? 

5.2 Bubble memories 

5.3 Cassettes or other tape based storage 

5.4 Other technologies 



6. HUMAN INTERFACE: INPUTS 

6.1 Typewriter keyboard 

This is probably a necessity. Atkinson points out that the halves are 
separable. Keyboard should be software mapped if possible (any combination 
should be valid). 

6.1.1 Keyboard layout 

6.1.2 Keyboard electronics 

6.2 Microphone 

6.2.1 As add-on accessory 

6.2.2 As built-in. It may be possible to use speaker as microphone 
although separate microphone probably preferable 

6.3 Audio (this and 6.2 with built-in A/D) 

6.4 Photocell (perhaps in conjunction with a light pen or wand?) 

6.5 Graphic input: joystick, force stick, ball, or tablet 

6.6 Other transducer input: pressure, moisture, temperature etc. 



7 . COMMUNICATIONS 

7.1 RS232 

7.2 Phone connector (built-in modem and DAA) . 

7.3 Applenet 

7.4 Other 

7.4.1 WWV reciever 

7.4.2 TV or radio receiver 

7.5 RF link 

7.6 To a paging system 

7.7 IEEE 488 



8 . SOFTWARE 

8.1 Major design critera 

8.1.1 "Zero defect" programming 

8.1.2 Excellence of human interface 

8.1.3 Extraordinary testing 

8.2 Initial software offering 

There must be a large Initial offering of software. Some examples might 
be 

8.2.1 Checkbook balancing 

8.2.2 Many games (it will be seen as a toy to some purchasers) 

8.2.2.1 Chess 

8.2.2.2 Backgararaon 

5.2.3 Word Processor 
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8.2.4 BASIC 

8.2.5 Elementary communications protocols 

8.2.6 Instructional programs (e.g. typing, arithmetic) 

8.2.7 Daytimer (can we license use of this name?) 

8.2.8 Personal 'phone book 

8.2.9 Bulletin board 

8.2.10 Business software 

8.2.11 Telephone simulator (it has a mike and speaker) 

8.2.12 Terminal simulator (also: data entry device) 

8.2.13 High precision scientific calculator 

Note that many of these packages could be applications of a more general 
DBM system with preset data and structure. 



8.3 Cumulative software effort 

8.4 User languages 

8.4.1 BASIC 

8.4.2 APL 

8.4.3 Pascal 

8.4.4 Other 

8.5 System development languages 

8.5.1 Pascal 

8.5.2 Forth 

8.5.3 Assembler 

8.5.4 Other 

8.6 Application development languages 

8.6.1 Pascal 

8.6.2 Pilot 

8.6.3 Other 

8.7 Software security 

8.8 Operating system 

9. MANUALS 

9.1 Self -teaching, on-line manuals 

9.2 Reference manuals 

10. SCHEDULE (very preliminary) 

1 Nov 79 Preliminary design spec 

1 Mar 80 Final design spec 

1 Jul 80 Engineering Prototype 

1 Mar 81 Prototype for shows 

1 Sep 81 Production in time for Xmas 81 



11. RESOURCES REQUIRED 

11.1 Personnel 

11.2 Capital equipment 

11.3 Supplies 



12. TESTINC- 

12.1 In house 

12.2 On a wide range of potential users 

12.3 Of completed systems/programs /manuals 



13. EXPF.RI^fENTATION ' 

13.1 With competitive machines 
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A. HP-AIC 

B. Atari 400 

13.2 With technologies 

A. Attach a touch-panel to an Apple II 

B. Attach a few small-screen CRT's to Apples- 

13.3 By prograraming simulations 

A. Small screen sizes (in terms of resolution and characters) 

B. Simple editors (e.g. my "one command" editor) 

13.4 With services 

A. TCA 

B . PCNET 

C. Other "bulletin board" services 

D. DIALOG (Lockheed) BALLOTS (Stanford) 



14. ENCLOSURE AND COSMETICS 

14.1 Design and materials 

14.2 Thermal considerations 

14.3 Choice of colors and case styles 

If this is to be truly a product for the home, shouldn't we offer it 
in various colors? Matched to the 5 standard home appliance colors? 
There is also the possibility of offering options such as a wooden case. 

14.4 Self-protecting case design (lid opens to become display, for example) 

14.5 A handle. 

14.6 If the design is modular, the parts should snap together electrically 
as well as mechanically. 



15. PRINTER AND HARD COPY PICTURES 

15.1 Built-in 

15.1.1 Film based (polaroid or other quick technology) 

15.1.2 Thermal ' 

15.1.3 Electrostatic 

15.1.4 Dot-matrix impact ' 

15.1.5 Ink jet 

15.1.6 Laser 

15.1.7 Other 

15.2 External 

15.2.1 Letter quality 

Is it silly to try to sell $3000 printers with this machine? 

15.2.2 Portables 

All the possibilities under 15.1 fit here as well. 

15.3 Width of paper (8.5 inch probably) 

16. OTHER PERIPHERALS AND FEATURES 

16.1 AC switched outlets (possibly computer controlled) 

16.2 Speaker (with speech and/or music synthesizers?) 

16.3 Credit card reader or HP card reader or both 

16.4 Real time clock (essential) 

Perhaps based on a watch module, always runs. 

16.5 Actuators (e.g. R/C servos) 

16.6 TTL outputs 

16.7 Soft "off" switch- 

16.8 Plotter 

16.9 Check reader 
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L7. THE APPLE TIMESHARING NETTTORK 

One of the most powerful uses of Macintosh will become viable only if 
a service such as TCA is available. We will have to consider setting 
up a nation (world?) wide set of local numbers for a number of purposes 
to be covered in another document. A standard protocol will have to be 
promulgated . 



18. FUTURE PRODUCTS IN THE MACINTOSH FAMILY 

Items rejected from consideration as built-in may be moved here, as well 
as new ideas. 



19. IMPACT ON VARIOUS DEPARTMENTS OF APPLE 

19.1 Purchasing 

19.2 Manufacturing 

19.3 Marketing 

19.3.1 Advertising 

19.3.2 Dealers 

19.4 Engineering 

19.4.1 System software 

19.4.2 Applications software 

19.4.3 Analog electronics 

19.4.4 Digital electronics 

19.4.5 Mechanical engineering 

19.5 Publications 

19.6 New Product Review 

19.7 Service 



20. ANALYSIS OF COMPETITION 

20.1 Atari 

20.2 Texas Instrument 

20.3 Commodore 

20.4 Tandy 

20.5 Japan 

20.6 Calculators 

20.7 Mattel 

20.8 Typewriters 

20.9 Accounting machines 

20.10 Electronic games 

20.11 Video games 

20.12 Other 

2 1 . CPU 

It is assumed, for the time being, that memory will be byte oriented, and 
that the CPU or CPUs will be 8 or 16 bits or some mix of the two. 

21.1 Single or multiple CPU 

21.2 Off-shelf or our own 
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THE MACINTOSH PROJECT 
DOCUMENT 3 VERSION 5 



TITLE; THE APPLE COMPUTER NETWORK 



AUTHOR: JEF RASKIN 



DATE; 11 Sep 79-11 Oct 79 



1 INTRODUCTION 



There are very few potential uses of the personal computer per se in the home 
at the present time. The question "What do you do with it?" still haunts the 
industry. While balancing checkbooks, playing chess and writing letters are 
all viable uses, it is likely that a true mass market cannot be supported on 
the basis of such applications. In the face of this problem, most 
manufacturers, seeing the hobbyist and technophile markets becoming 
saturated, have turned to marketing business systems. The business system 
market is big and legitimate opportunities abound there, but the volume 
can never be as large as it would be for an item that goes to consumers in 
general . 

There is a feeling in the industry that telecommunications will become a key 
part of every computer market segment, and this Is increasingly becoming so. 
Many experiments and a few successful services are in operation. Aside from 
long-standing timesharing systems such as GE and TYMSHARE, we have the ARPA 
net, Xerox's internal Ethernet, TCA (alias "The Source"), Prestel, the MECC 
network, and many others. Appendix 1 lists a few commercial services that 
may be of interest to us. A set of "underground" message centers have come 
into operation, for example, the PCNET. There are also a few other 
individuals and small groups that set up a microcomputer with an autoanswer 
modem and some software that allows users to leave and retrieve messages. 

According to "Computer Retailer'.', Radio Shack and Western Union are 
working out some cooperative venture involving WU's "Mailgram" service 
whereby Radio Shack computer owners can exchange messages. 

It is clear that one answer to the question "What do you do with it?" will 
probably be: "I use it" to send birthday greetings to Aunt Tillie." More to 
the point there are a number of easily forseen potential uses for a network 
of personal computers. What is more exciting is that, as has happened with 
the computers themselves, there is the potential for many 
unf orseen applications. 



1.2 POSSIBLE APPLICATION AREAS 



Many applications have been put forward. Among them are: 

Time of day; News (with a boolean query data base); Stock Market (as per what 
we are already doing); Soap Opera Condensations; A guide to local TV prograns 
(what's on at 9:00PM?, any westerns tonight?); Message forwarding and 
distribution; Fax transmission (special case of message: the bits are 
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interpreted pictorially) ; Weather Travel Info; Phone directory; Local, area 
or national business directory; Apple program distribution channel; Apple 
update distribution channel; Access to Lockheed's DIALOG or Stanford's 
BALLOTS systems or similar ones; A better way to answer user questions than a 
phone based hotline at Apple; Library of Congress card catalog; Legal 
precedents; Program exchange; Educational courses; Educational testing; 
Voting; Computer program exchange; Advertising; Computer dating; Tax 
information; Banking (another step to the cashless society (If taxes don't 
reduce us to a cashless state first)); Access to large data storage for 
individual needs; Access to computer power (i.e. timesharing); Insurance 
quotes; Credit information (what is available: what is my status); Market 
research; Purchasing information (who has the cheapest refrigerator model 34- 
aa within 10 miles); Plane schedules; Dictionary and Encyclopedia searches. 

The list is potentially endless- Most come under one heading: Access to a 
Data Base. A few come under the heading: Communication. The remaining 
handful are miscellaneous. 



The point of this list is that telecommunications provides a host of answers 
to the "What do you do with it?" question. What follows is a proposal for 
supplying customers with this kind of service. 

2. IMPLEMENTATION OF AN APPLE TELECOMMUNICATION SYSTEM 

2.1 SOME NON-TECHNICAL PROBLEMS 



It is clear that setting up any kind of independent communications network 
runs afoul of many bureaucratic agencies, and would alarm many companies now 
in the communications industry. For these reasons alone, it is best to use 
existing communication channels. The problems of being a user of such a 
system are probably less than the problems of being in the industry, 
document M 12 discusses some of the potential problems with being a 
user of the telephone network. 



2.2 NEED FOR PROMPT AND AGGRESSIVE POLICY 



Apple cannot possibly create the data bases that are required to make this 
proposal viable. As we have done with Dow Jones, we will have to negotiate 
access for our users to existing data bases and services. Our success in 
this field will depend on aggressive and prompt action to secure (possibly 
exclusive) use (with respect to personal computers) of what we see as the 
most important services. 

2.3 TELEPHONE BASED SYSTEM 

The most universal bidirectional data path to homes in this country is the 
telephone. We presently have the technology to provide a low-cost computer 
with a 300 baud modem. Since the Carterphone decision, access to the 
telephone network has been assured (as least as much as anything can be 
assured in the communications field). There are a number of ways of 
providing a universal service through the telephone. 

2.3.1 MANY LOCAL NUMBERS 
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The time sharing services have chosen to have many regional centers or data 
accumulation points. Dow Jones, for example, provides many local numbers. 
There are some disadvantages to this scheme: it requires publishing a book 
of telephone numbers, and some subscribers have to make toll calls if they do 
not live in or very close to a major population center. One advantage of 
this system is its redundancy. 

2.2.2 A TOLL-FREE NUMBER 

With one (or perhaps two) toll-free numbers, every phone in the country can 
have access Co a central computer installation or what I will call an A- 
node (explained below). This has the psychological advantage of making 
access to the service appear "free". The number is easily advertised, again 
encouraging use. Research will have to be done to determine the expected 
density of useage and just how practical such a system would be. 

2.4 LIMITED OR UNIVERSAL ACCESS 

Can we, or should we try to, limit access to owners of Apple products? If 
we allow access to anybody with proper equipment (probably any computer or, 
perhaps, even some terminals) can we legally build in advantages for Apple 
owners? For example, the only software available will be for Apples. If 
we use some technological means of permitting only Apples into the service, 
this would require special hardware and/or software in future products, and 
might not be retro-f itCable to the Apple 11 series. 

It is my feeling that access should be universal, with some unique services 
for Apple owners. Greg Justice is devising an inexpensive modem for 1200 
baud half duplex telephone line communications. This might be an Apple ex- 
clusive. 

2.5 TECHNICAL PROBLEMS 

If credit or any other sensitive information is involved, security measures 
will be necessary. Security problems are inevitable in any case since we 
wish to bill our customers for their useage of at least some parts of the 
service. Use of other parts may be paid for by the suppliers (e.g. when the 
service amounts to advertising) and thus seem free to the user. D. E. 
Denning, in her article "Secure Personal Computing in an Interactive 
Network" (CACM Vol. 22, No. 8) suggests a method for implementing security 
where the users, rather than the network, have control of security. While I 
question the implementation suggested there, the idea that security can cone 
from the user's side is a good one. 

Protocols will have to be carefully defined, simple enough for naive users, 
yet powerful enough to cope with any data base to which we subscribe. There 
may have to be, as with the PCNET protocols, levels of access from the 
beginner's character stream to the expert's auto-path-finding data 
compressed packet. If we are fast enough, the protocols we design may be- 
come a de facto standard. 

2.5.1 INTERFACIAL SOFTWARE 

One way of easing the user's problem at accessing the many data bases that 
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exist would be to provide, as we have begun Co do for the Dow Jones services 
programs that iron out the difficulties of using the various services, so 
that they all appear relatively uniform and easy to use. 

This would become an ongoing software project for Apple, and would represent 
the least involved method of providing access to data bases. It would not 
provide a universal message transfer system, however, and thus possibly 
decrease the desirability of the Macintosh system. It would also not provide 
a single telephone number for all services, and might require each user to 
have multiple contracts. Users would not be encouraged to try more services 
as much as they might if the services were more consolidated. 

If we adopt this approach, we will have to define a set of unified protocols 
for accessing data bases — of diverse kinds. This is no easy task, since most 
of them were designed quite independently. 

2.5.2 ESTABLISHING A-NODES 



The next level up in user convenience from providing software for stand-alone 
Apples to facilitate access to each data base would be to provide an A- 
node, or data concentration center or centers. This A-node would be accessed 
through a single protocol from the user's computer, and then the A-node 
would initiate and monitor (for billing purposes) the connection with the 
various data base systems. This process would Insulate the user from having 
to be familiar with each different data base's telephone number and 
protocols . 

The A-node would also be a message storing and forwarding center. 

3. IMPLICATIONS FOR THE MACINTOSH PROJECT 

This proposal grew out of attempting to answer the "What do you do with it?" 
question. Without some sort of network/data base service the question is 
going to be much harder to answer. I am proposing here that the creation of 
Apple communications, in some form, is part of the definition of the 
Macintosh computer project. 

4. IMPLICATIONS FOR APPLE COMPUTER INC 

We don't think of the telephone company primarily as a manufacturer of the 
little $40 things with* dials or pushbuttons that we have in our homes and on 
our desks. The implications of this proposal, at one extreme, is that Apple 
will be seen, in the future, not so much as a builder of hardware, but as the 
purveyor of a service that interpenetrates the telephone network, and 
provides information. 

On the other extreme, Apple will be In its present position, adding access to 
data bases on a piecemeal fashion. Message transfer will not become a 
useful function unless somebody else happens to start a message system that 
is universal enough and otherwise meets our needs. I do not like trusting to 
luck. 



The high cost to Apple of having done our early software piecemeal and in an 
ad hoc manner should act as an example of why we should not let our 
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connunicacions effort be similarly scattered. 

The intermediate approach, using the A-node, may be the most practical. At 
least its requirements are not excessive in terms of hardware or software, 
and it can start as a mere message center (for the whole United States at 
first) and then grow as we contract with providers of data bases and bring 
them on line. 



This proposal, if it is carried out, will represent an additional direction 
for the company. We will not be alone in the personal computer 
communications field, we can strive to be the best. Certain vested interests 
may be threatened by an Apple communications system, and there may be 
unpleasant pressures. 



5. SUMMARY 



It is my opinion that the A-nodes provide a practical solution to a good 
portion of the "What do you do with it?" question. If, in the next few 
months, a clear alternative occurs (such as might be provided by the growth 
of a company such as TCA) we should consider it. We must do something in the 
way of providing communication between Apples in locations distant from each 
other, and communication with sources of information. 

Mike Markkula has suggested that this may be an undesireable path In that 
others will be doing it, and we can use their services. He further suggested 
that we establish a protocol early on, and publish it in order to obtain a 
leadership position. I agree with trying to establish the protocols early, 
and promulgating them, but I think we must also press ahead with a detailed 
study of the costs and benefits of our own system. 

I am concerned that many of the existing services are either too poorly set 
up, or don't have the breadth of vision required. We may also need growth 
rates not anticipated by the existing companies. If we do not have a 
communications network to use, then what will people do with the million 
Macintoshes we wish to produce? 
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APPENDIX 1, SOME SOURCES OF DATA BASES AND COMMUNICATIONS 



Telecomputing Corporation of America 
1616 Anderson Road 
Mclean, Virginia 22102 

A service designed for the personal computer user. 
"The Source". Advertises in Byte. 



It is commonly called 



Computserve, Personal Computing Division 
5000 Arlington Centre Blvd. 
Columbus, Ohio A3220 

Tradenamed "Micronet", it is a less ambitious project than The Source. 
Advertises in Byte. 

SDC Search Service 
2500 Colorado Ave. 
Santa Monica, CA 90406 

A commercial service with no special attention to microcomputer users, 
mentioned here because it has a wide range of services. 

The Information Bank 
1719 Route 10 
Parsippay, NJ 07054 

A news service to the New York Times, Wall Street Journal, Business 
Week and some 60 other publications. No special attention to micro- 
computer users. 

Lockheed's Dialog data base and Stanford's BALLOTS would be fine 
candidates, along with our existing Dow Jones service. All in all, there are 
many services available. A listing of such services appears in the 
Applications Directory of The Association of Time Sharing Users, Inc., P.O. 
Box 9003, Boulder, CO 80301. Almost all the services listed there provide 
economic, stock and commodity, market or demographic information. The two 
two most interesting from that list are shown above. Thanks to Tom Whitney 
for showing me this catalog. 
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